機械翻訳について

移動先

• リクエスト
• レスポンス
• 例

アクセス・レビューのインサイトの取得

get

/access-governance/access-reviews/20250331/accessReviews/{accessReviewId}/insights

指定されたaccessReviewIdのアクセス・レビューのインサイトを返します。

リクエスト

パス・パラメータ

• accessReviewId(required): string
  一意のアクセス・レビュー識別子。

ヘッダー・パラメータ

• opc-request-id: string
  トレース用のクライアント・リクエストID。 リクエストIDに有効な文字は、文字、数字、アンダースコアおよびダッシュのみです。

トップに戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200レスポンス

アクセス・レビューのインサイト。

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : AccessReviewInsights

型: object

指定されたアクセス・レビューのインサイト情報。

ソースを表示

• alignments: array alignments
  線形情報のリスト。
• identityCollectionMembership: object IdentityCollectionMembership
  アイデンティティ・コレクション内のメンバーの数。
• insights: array insights
  インサイトのリスト。
• locationAlignments: array locationAlignments
  ロケーション合わせ情報のリスト。
• peerSimilarities: array peerSimilarities
  ピア類似性情報のリスト。
• textualExplanations: array textualExplanations
  テキスト説明のリスト。
• version(必須): integer
  インサイト形式のバージョン。

{
    "type":"object",
    "description":"The insight information for the given access review.",
    "required":[
        "version"
    ],
    "properties":{
        "version":{
            "type":"integer",
            "description":"The version of the insights format."
        },
        "alignments":{
            "type":"array",
            "description":"The list of alignment information.",
            "items":{
                "$ref":"#/definitions/Alignment"
            }
        },
        "insights":{
            "type":"array",
            "description":"The list of insights.",
            "items":{
                "$ref":"#/definitions/InsightAttribute"
            }
        },
        "locationAlignments":{
            "type":"array",
            "description":"The list of location alignment information.",
            "items":{
                "$ref":"#/definitions/LocationAlignment"
            }
        },
        "peerSimilarities":{
            "type":"array",
            "description":"The list of peer similarities information.",
            "items":{
                "$ref":"#/definitions/PeerSimilarity"
            }
        },
        "identityCollectionMembership":{
            "$ref":"#/definitions/IdentityCollectionMembership"
        },
        "textualExplanations":{
            "type":"array",
            "description":"The list of textual explanation.",
            "items":{
                "$ref":"#/definitions/TextualExplanation"
            }
        }
    }
}

ネストされたスキーマ : 整列

型: array

線形情報のリスト。

ソースを表示

• Array of: object Alignment
  指定されたアイデンティティ・コレクションの整列情報。

{
    "type":"array",
    "description":"The list of alignment information.",
    "items":{
        "$ref":"#/definitions/Alignment"
    }
}

ネストされたスキーマ : IdentityCollectionMembership

型: object

アイデンティティ・コレクション内のメンバーの数。

ソースを表示

• current(required): integer
  アイデンティティ・コレクションの現在のメンバー数。
• expected(required): integer
  アイデンティティ・コレクションに必要なメンバー数。

{
    "type":"object",
    "required":[
        "current",
        "expected"
    ],
    "properties":{
        "current":{
            "type":"integer",
            "description":"The current member count in the identity collection."
        },
        "expected":{
            "type":"integer",
            "description":"The expected member count in the identity collection."
        }
    },
    "description":"The count for members in the identity collection."
}

ネストされたスキーマ : インサイト

型: array

インサイトのリスト。

ソースを表示

• Array of: object InsightAttribute
  インサイト属性

{
    "type":"array",
    "description":"The list of insights.",
    "items":{
        "$ref":"#/definitions/InsightAttribute"
    }
}

ネストされたスキーマ : locationAlignments

型: array

ロケーション合わせ情報のリスト。

ソースを表示

• Array of: object LocationAlignment
  ロケーションに基づいた、指定されたアイデンティティ・コレクションの配置情報

{
    "type":"array",
    "description":"The list of location alignment information.",
    "items":{
        "$ref":"#/definitions/LocationAlignment"
    }
}

ネストされたスキーマ : peerSimilarities

型: array

ピア類似性情報のリスト。

ソースを表示

• Array of: object PeerSimilarity
  ピア類似性情報のリスト

{
    "type":"array",
    "description":"The list of peer similarities information.",
    "items":{
        "$ref":"#/definitions/PeerSimilarity"
    }
}

ネストされたスキーマ : textualExplanations

型: array

テキスト説明のリスト。

ソースを表示

• Array of: object TextualExplanation
  レビュー推奨のテキスト説明

{
    "type":"array",
    "description":"The list of textual explanation.",
    "items":{
        "$ref":"#/definitions/TextualExplanation"
    }
}

ネストされたスキーマ : 調整

型: object

指定されたアイデンティティ・コレクションの整列情報。

ソースを表示

• type(必須): string
  許容値: [ "SAME_MANAGER", "SAME_JOB_CODE", "SAME_ORGANIZATION", "DIRECT_REPORT" ]

  線形の値
• value(必須): integer
  整列のパーセント値

{
    "type":"object",
    "required":[
        "type",
        "value"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"The value of the alignment",
            "enum":[
                "SAME_MANAGER",
                "SAME_JOB_CODE",
                "SAME_ORGANIZATION",
                "DIRECT_REPORT"
            ],
            "x-obmcs-top-level-enum":"#/definitions/AlignmentType"
        },
        "value":{
            "type":"integer",
            "description":"The percentage value of the alignment"
        }
    },
    "description":"The alignment information for the given Identity Collection."
}

ネストされたスキーマ : InsightAttribute

型: object

インサイト属性

ソースを表示

• priority: integer
  インサイト属性の優先度
• type(必須): string
  許容値: [ "RECOMMENDATION", "ANALYSIS_RESULT", "RECENT_CHANGE" ]

  インサイト属性のタイプ
• value(required): string
  インサイト属性の値

{
    "type":"object",
    "required":[
        "type",
        "value"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"The type of the insight attribute",
            "enum":[
                "RECOMMENDATION",
                "ANALYSIS_RESULT",
                "RECENT_CHANGE"
            ],
            "x-obmcs-top-level-enum":"#/definitions/InsightAttributeType"
        },
        "value":{
            "type":"string",
            "description":"The value of the insight attribute"
        },
        "priority":{
            "type":"integer",
            "description":"The priority of the insight attribute"
        }
    },
    "description":"The insight attribute"
}

ネストされたスキーマ : LocationAlignment

型: object

ロケーションに基づいた、指定されたアイデンティティ・コレクションの配置情報

ソースを表示

• locationScores: array locationScores
  この連携タイプのロケーションごとのスコア
• type(必須): string
  許容値: [ "SAME_MANAGER", "SAME_JOB_CODE", "SAME_ORGANIZATION", "DIRECT_REPORT" ]

  線形の値

{
    "type":"object",
    "required":[
        "type"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"The value of the alignment",
            "enum":[
                "SAME_MANAGER",
                "SAME_JOB_CODE",
                "SAME_ORGANIZATION",
                "DIRECT_REPORT"
            ],
            "x-obmcs-top-level-enum":"#/definitions/AlignmentType"
        },
        "locationScores":{
            "type":"array",
            "description":"The scores per location for this alignment type",
            "items":{
                "$ref":"#/definitions/LocationScore"
            }
        }
    },
    "description":"The alignment information for the given Identity Collection based on a location"
}

ネストされたスキーマ : locationScores

型: array

この連携タイプのロケーションごとのスコア

ソースを表示

• Array of: object LocationScore
  指定されたロケーションの連携スコア

{
    "type":"array",
    "description":"The scores per location for this alignment type",
    "items":{
        "$ref":"#/definitions/LocationScore"
    }
}

ネストされたスキーマ : LocationScore

型: object

指定されたロケーションの連携スコア

ソースを表示

• location(required): string
  スコアのロケーション
• matchedCount(required): integer
  ロケーションの一致したピアの数
• totalCount(required): integer
  ロケーションのピアの合計数
• value(必須): integer
  事業所の連携スコアのパーセント値

{
    "type":"object",
    "required":[
        "location",
        "matchedCount",
        "totalCount",
        "value"
    ],
    "properties":{
        "location":{
            "type":"string",
            "description":"The location for the score"
        },
        "matchedCount":{
            "type":"integer",
            "description":"The matched count of peers for the location"
        },
        "totalCount":{
            "type":"integer",
            "description":"The total count of peers for the location"
        },
        "value":{
            "type":"integer",
            "description":"The percentage value for the alignment score for the location"
        }
    },
    "description":"The alignment score for the given location"
}

ネストされたスキーマ : PeerSimilarity

型: object

ピア類似性情報のリスト

ソースを表示

• similarities(required): array similarities
  この連携タイプの類似点のリスト
• type(必須): string
  許容値: [ "SAME_MANAGER", "SAME_JOB_CODE", "SAME_ORGANIZATION", "DIRECT_REPORT" ]

  線形の値

{
    "type":"object",
    "required":[
        "similarities",
        "type"
    ],
    "properties":{
        "type":{
            "type":"string",
            "description":"The value of the alignment",
            "enum":[
                "SAME_MANAGER",
                "SAME_JOB_CODE",
                "SAME_ORGANIZATION",
                "DIRECT_REPORT"
            ],
            "x-obmcs-top-level-enum":"#/definitions/AlignmentType"
        },
        "similarities":{
            "type":"array",
            "description":"The list of similarities for this alignment type",
            "items":{
                "$ref":"#/definitions/Similarity"
            }
        }
    },
    "description":"The list of peer similarities information"
}

ネストされたスキーマ : 類似点

型: array

この連携タイプの類似点のリスト

ソースを表示

• Array of: object Similarity
  類似性情報

{
    "type":"array",
    "description":"The list of similarities for this alignment type",
    "items":{
        "$ref":"#/definitions/Similarity"
    }
}

ネストされたスキーマ : 類似性

型: object

類似性情報

ソースを表示

• individual(required): number(float)
  ピアと類似性を持つ個人の割合
• location(required): string
  スコアのロケーション
• peerCount(required): integer
  ロケーションのピアの数
• peers(required): number(float)
  ピアの平均類似率

{
    "type":"object",
    "required":[
        "individual",
        "location",
        "peerCount",
        "peers"
    ],
    "properties":{
        "location":{
            "type":"string",
            "description":"The location for the score"
        },
        "individual":{
            "type":"number",
            "format":"float",
            "description":"The percentage of individuals with similarity to their peers"
        },
        "peers":{
            "type":"number",
            "format":"float",
            "description":"The average similarity percentage of peers"
        },
        "peerCount":{
            "type":"integer",
            "description":"the count of the peers for the location"
        }
    },
    "description":"The similarity information"
}

ネストされたスキーマ : TextualExplanation

型: object

レビュー推奨のテキスト説明

ソースを表示

• attributes(required): array attributes
  最大アイテム数: 4

  テキスト説明の属性
• explanation(required): string
  テキストの説明

{
    "type":"object",
    "description":"Textual explanation of review recommendation",
    "required":[
        "explanation",
        "attributes"
    ],
    "properties":{
        "explanation":{
            "type":"string",
            "description":"Textual explanation"
        },
        "attributes":{
            "type":"array",
            "description":"Attributes of textual explanation",
            "items":{
                "type":"string"
            },
            "maxItems":4
        }
    }
}

ネストされたスキーマ: attributes

型: array

最大アイテム数: 4

テキスト説明の属性

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"Attributes of textual explanation",
    "items":{
        "type":"string"
    },
    "maxItems":4
}

400レスポンス

不正なリクエスト

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

401レスポンス

未認可

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

404レスポンス

見つかりません

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

429レスポンス

リクエストが多すぎます

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

500レスポンス

内部サーバー・エラー

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

デフォルト・レスポンス

不明なエラー

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : Error

型: object

エラー情報。

ソースを表示

• code(必須): string
  プログラム解析用のエラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列。

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "description":"Error Information."
}

トップに戻る

例

次の例は、特定のアクセス・レビュー・タスクのインサイトを取得する方法を示しています。 accessReviewIdパス・パラメータは必須です。

cURLの例

curl -i -X GET \
   -H "Authorization:Bearer <your access token>" \
 '${service-instance-url}/access-governance/access-reviews/${version}/accessReviews/${accessReviewId}/insights'

レスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。

{
    "version": 3,
    "alignments": null,
    "insights": null,
    "locationAlignments": null,
    "peerSimilarities": [
        {
            "type": "SAME_MANAGER",
            "name": null,
            "similarities": null
        },
        {
            "type": "SAME_JOB_CODE",
            "name": null,
            "similarities": null
        },
        {
            "type": "SAME_ORGANIZATION",
            "name": null,
            "similarities": null
        }
    ],
    "identityCollectionMembership": null,
    "textualExplanations": [
        {
            "explanation": "This identity has no peers across <strong>all</strong> locations with the same: ",
            "attributes": ["Job code"]
        }
    ]
}

先頭に戻る