機械翻訳について

移動先

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

職務分掌のリクエスト分析(非同期)

post

/access-governance/service-administration/20250331/orchestratedSystem/{orchestratedSystemId}/sod/analyze

オーケストレート済システムの職務分離の分析を開始します。 リクエストは非同期で、ステータスの確認に使用できるrequestIdを返します。

リクエスト

パス・パラメータ

• orchestratedSystemId(required): string
  オーケストレーション・システムの一意のID。 使用可能な値は、ListOrchestratedSystems操作を使用して確認できます。

ヘッダー・パラメータ

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

本文()

職務分掌分析の実行の詳細をリクエストします。

ルート・スキーマ : SeparationOfDutiesAnalysisDetails

型: object

職務分掌分析を実行するための詳細。

ソースを表示

• accountData: object AccountData
  ユーザー・アカウントに関する情報。
• orchestratedSystemIdentityId: string
  オーケストレート済システム上のアイデンティティのID。
• permissionAssignments(required): array permissionAssignments
  アカウントとともに分析される権限。
• requestedBy(required): string
  分析をリクエストしたユーザー。

{
    "type":"object",
    "required":[
        "permissionAssignments",
        "requestedBy"
    ],
    "properties":{
        "orchestratedSystemIdentityId":{
            "type":"string",
            "description":"The ID of the Identity on the Orchestrated System."
        },
        "accountData":{
            "$ref":"#/definitions/AccountData"
        },
        "permissionAssignments":{
            "type":"array",
            "description":"Permissions to be analyzed along with the account.",
            "items":{
                "$ref":"#/definitions/AccountPermission"
            }
        },
        "requestedBy":{
            "type":"string",
            "description":"The user who requested the analysis."
        }
    },
    "description":"Details for performing Separation of Duties analysis."
}

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

型: object

ユーザー・アカウントに関する情報。

ソースを表示

• attributes(required): array attributes
  アカウント属性

{
    "type":"object",
    "required":[
        "attributes"
    ],
    "properties":{
        "attributes":{
            "type":"array",
            "description":"Account attributes.",
            "items":{
                "$ref":"#/definitions/Attribute"
            }
        }
    },
    "description":"Information about the user account."
}

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

型: array

アカウントとともに分析される権限。

ソースを表示

• Array of: object AccountPermission
  スキャンする権限。

{
    "type":"array",
    "description":"Permissions to be analyzed along with the account.",
    "items":{
        "$ref":"#/definitions/AccountPermission"
    }
}

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

型: array

アカウント属性

ソースを表示

• 配列: オブジェクト Attribute
  アカウントの属性。

{
    "type":"array",
    "description":"Account attributes.",
    "items":{
        "$ref":"#/definitions/Attribute"
    }
}

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

型: object

アカウントの属性。

ソースを表示

• action: string
  許容値: [ "ADD", "UPDATE" ]

  属性に対して実行される操作。
• additionalAttributes: array additionalAttributes
  追加属性
• attributes: array attributes
  Attributes.
• displayName: string
  属性の表示名。
• name(required): string
  属性の名前。
• value: array value
  属性の値。

{
    "type":"object",
    "required":[
        "name"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the attribute."
        },
        "displayName":{
            "type":"string",
            "description":"Display Name of the attribute."
        },
        "value":{
            "type":"array",
            "description":"Value of the attribute.",
            "items":{
                "type":"string"
            }
        },
        "action":{
            "type":"string",
            "description":"Operation to be done on the attribute.",
            "enum":[
                "ADD",
                "UPDATE"
            ],
            "x-obmcs-top-level-enum":"#/definitions/AttributeAction"
        },
        "additionalAttributes":{
            "type":"array",
            "description":"Additional attributes.",
            "items":{
                "$ref":"#/definitions/AdditionalAttribute"
            }
        },
        "attributes":{
            "type":"array",
            "description":"Attributes.",
            "items":{
                "$ref":"#/definitions/Attribute"
            }
        }
    },
    "description":"Attribute of the account."
}

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

型: array

追加属性

ソースを表示

• Array of: object AdditionalAttribute
  追加属性

{
    "type":"array",
    "description":"Additional attributes.",
    "items":{
        "$ref":"#/definitions/AdditionalAttribute"
    }
}

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

型: array

Attributes.

ソースを表示

• 配列: オブジェクト Attribute
  アカウントの属性。

{
    "type":"array",
    "description":"Attributes.",
    "items":{
        "$ref":"#/definitions/Attribute"
    }
}

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

型: array

属性の値。

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"Value of the attribute.",
    "items":{
        "type":"string"
    }
}

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

型: object

追加属性

ソースを表示

• name(required): string
  属性の名前。
• value(required): array value
  属性の値。

{
    "type":"object",
    "required":[
        "name",
        "value"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the attribute."
        },
        "value":{
            "type":"array",
            "description":"Value of the attribute.",
            "items":{
                "type":"string"
            }
        }
    },
    "description":"Additional Attribute."
}

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

型: array

属性の値。

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"Value of the attribute.",
    "items":{
        "type":"string"
    }
}

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

型: object

スキャンする権限。

ソースを表示

• action(required): string
  許容値: [ "ADD", "UPDATE" ]

  許可に対する処理。
• attributes(required): array attributes
  アカウント属性
• id(必須): string
  権限ID。

{
    "type":"object",
    "required":[
        "action",
        "attributes",
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"Permission ID."
        },
        "action":{
            "type":"string",
            "description":"Action on the permission.",
            "enum":[
                "ADD",
                "UPDATE"
            ],
            "x-obmcs-top-level-enum":"#/definitions/AttributeAction"
        },
        "attributes":{
            "type":"array",
            "description":"Account attributes.",
            "items":{
                "$ref":"#/definitions/Attribute"
            }
        }
    },
    "description":"Permission to be scanned."
}

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

型: array

アカウント属性

ソースを表示

• 配列: オブジェクト Attribute
  アカウントの属性。

{
    "type":"array",
    "description":"Account attributes.",
    "items":{
        "$ref":"#/definitions/Attribute"
    }
}

トップに戻る

レスポンス

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

• application/json

200レスポンス

処理のために受け入れられた分析リクエストを実行します。

ヘッダー

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

本文()

ルート・スキーマ : SeparationOfDutiesAnalysisResponseDetails

型: object

分析リクエストの実行のレスポンス。

ソースを表示

• requestId(required): string
  一意の実行分析リクエスト識別子。
• status(必須): string
  リクエスト・ステータス

{
    "type":"object",
    "required":[
        "requestId",
        "status"
    ],
    "properties":{
        "requestId":{
            "type":"string",
            "description":"Unique perform analysis request identifier."
        },
        "status":{
            "type":"string",
            "description":"Request Status."
        }
    },
    "description":"Response of the perform analysis request."
}

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."
}

409レスポンス

競合

ヘッダー

• 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."
}

412レスポンス

事前条件は失敗しました

ヘッダー

• 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."
}

トップに戻る

例

次の例は、職務の分離を分析する方法を示しています。 これは、Oracle Fusion Cloud Applicationsオーケストレート済システムに適用可能で、Oracle Fusion Cloud Risk Management and Compliance (RMC)統合を有効にする必要があります。

このAPIを実行する前に、次のAPIを実行します:

• /access-governance/service-administration/${versionID}/orchestratedSystems/{orchestratedSystemId}/permissionsをGETして権限をフェッチ
• POST /access-governance/service-administration/${versionID}/orchestratedSystems/{orchestratedSystemId}/permissionAttributes
• orchestratedSystemIdentityIdとして使用されるidentityTargetIdをフェッチするGET /access-governance/identities/20250331/identities

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your access token>" \
   -H "Content-Type:application/json" \
   -d \
'{
    "orchestratedSystemIdentityId": "targetId.account.ICF.xxx-efc9-4a9a-bae9-26eefecaadf1.3b3f2e1a4f60938fc313659602ac4402",
    "permissionAssignments": [
        {
            "id": "roles.ICF.306d8290-xxx-4a9a-bae9-26eefecaadf1.f8326a90ddb243bccb4761a01961d7be",
            "action": "ADD",
            "attributes": [
                {
                    "name": "roles",
                    "value": [
                        "ADB4281383Fxx8CB16BF17AA4FDECAA"
                        ],
                    "additionalAttributes": [
                    ]
                }
            ]
        }
    ],
    "requestedBy": "amel"
}' \
 '${service-instance-url}/access-governance/service-administration/${versionID}/orchestratedSystems/${orchestratedSystemId}/sod/analyze'

リクエスト・ペイロードの例

RESTクライアント・ツールで、POSTリクエストを送信

${service-instance-url}/access-governance/service-administration/${versionID}/orchestratedSystems/${orchestratedSystemId}/sod/analyze'

{
    "orchestratedSystemIdentityId": "targetId.account.ICF.xxx-efc9-4a9a-bae9-26eefecaadf1.3b3f2e1a4f60938fc313659602ac4402",
    "permissionAssignments": [
        {
            "id": "roles.ICF.306d8290-xxx-4a9a-bae9-26eefecaadf1.f8326a90ddb243bccb4761a01961d7be",
            "action": "ADD",
            "attributes": [
                {
                    "name": "roles",
                    "value": [
                        "ADB4281383Fxx88CB16BF17AA4FDECAA"
                        ],
                    "additionalAttributes": [
                    ]
                }
            ]
        }
    ],
    "requestedBy": "amel"
}

レスポンス・コードの例

次のレスポンス本文とともに200 OKレスポンスを受信します:

{
    "requestId": "c87b487de125418ea73150bd62e5f2c7",
    "status": "InProgress"
}

requestIDを使用して、/access-governance/service-administration/20250331/orchestratedSystems/{orchestratedSystemId}/sod/statusを確認します。

先頭に戻る