機械翻訳について

移動先

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

承認タスクの一括処理(非同期)

post

/access-governance/access-controls/20250331/approvals/workRequest

1つ以上の承認タスクを非同期で一括処理します。 このアプローチは、50を超える承認タスクを処理する場合に使用します。

リクエスト

ヘッダー・パラメータ

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

本文()

承認タスクのセットに対して単一のアクションとコメントが含まれます。

ルート・スキーマ : ApprovalDecisionWorkRequestDetails

型: object

作業リクエストを作成するための一連のタスクの一括ディシジョン。

ソースを表示

• action(required): string
  許容値: [ "APPROVE", "REJECT" ]

  承認または拒否。
• approvalTimeLimit: object ApprovalTimeLimit
  承認時間制限に関する詳細(該当する場合)。 daysLimit、hoursLimitまたはtimeRangeLimitのいずれか1つのみを定義する必要があります。
• approvalTimeLimitType: string
  許容値: [ "INDEFINITELY", "NUMBER_OF_HOURS", "NUMBER_OF_DAYS", "DATE_TIME_RANGE", "EXTENSION" ]

  オプションの承認時間制限タイプです。 タイプがINDEFINITELYの場合、approvalTimeLimitおよびextensionTimeLimitは未定義のままにする必要があります。 型がNUMBER_OF_HOURS、NUMBER_OF_DAYSまたはDATE_TIME_RANGEの場合は、approvalTimeLimitを指定する必要があります。 typeがEXTENSIONの場合は、extensionTimeLimitを指定する必要があります。
• comment(required): string
  ディシジョンの理由。
• extensionTimeLimit: object ExtensionTimeLimit
  承認延長時間制限定義を終了時間として指定します。
• taskIds(required): array taskIds
  承認タスクIDのリスト。

{
    "type":"object",
    "required":[
        "action",
        "comment",
        "taskIds"
    ],
    "properties":{
        "taskIds":{
            "type":"array",
            "description":"List of Approval Task ids.",
            "items":{
                "type":"string"
            }
        },
        "action":{
            "type":"string",
            "description":"APPROVE or REJECT.",
            "enum":[
                "APPROVE",
                "REJECT"
            ],
            "x-obmcs-top-level-enum":"#/definitions/ApprovalDecisionType"
        },
        "comment":{
            "type":"string",
            "description":"Justification for decision."
        },
        "approvalTimeLimitType":{
            "type":"string",
            "description":"Optional approval time limit type.\nWhen type is INDEFINITELY, approvalTimeLimit and extensionTimeLimit should be left undefined.\nWhen type is NUMBER_OF_HOURS, NUMBER_OF_DAYS, or DATE_TIME_RANGE, approvalTimeLimit should be provided.\nWhen type is EXTENSION, extensionTimeLimit should be provided.\n",
            "enum":[
                "INDEFINITELY",
                "NUMBER_OF_HOURS",
                "NUMBER_OF_DAYS",
                "DATE_TIME_RANGE",
                "EXTENSION"
            ],
            "x-obmcs-top-level-enum":"#/definitions/ApprovalTimeLimitType",
            "x-default-description":"INDEFINITELY"
        },
        "approvalTimeLimit":{
            "$ref":"#/definitions/ApprovalTimeLimit"
        },
        "extensionTimeLimit":{
            "$ref":"#/definitions/ExtensionTimeLimit"
        }
    },
    "description":"A bulk decision for a set of tasks to create a work request."
}

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

型: object

承認時間制限に関する詳細(該当する場合)。 daysLimit、hoursLimitまたはtimeRangeLimitのいずれか1つのみを定義する必要があります。

ソースを表示

• daysLimit: integer
  最小値: 1

  最大値: 365

  承認時間制限の定義(日数)。
• hoursLimit: integer
  最小値: 1

  最大値: 24

  承認時間制限の定義(時間)。
• rangeLimit: object ApprovalTimeLimitRange
  時間範囲としての承認時間制限定義。

{
    "type":"object",
    "properties":{
        "daysLimit":{
            "type":"integer",
            "description":"Approval time limit definition in days.",
            "minimum":1,
            "maximum":365
        },
        "hoursLimit":{
            "type":"integer",
            "description":"Approval time limit definition in hours.",
            "minimum":1,
            "maximum":24
        },
        "rangeLimit":{
            "$ref":"#/definitions/ApprovalTimeLimitRange"
        }
    },
    "description":"Details about the approval time limit, when applicable. \nOnly one of daysLimit, hoursLimit, or timeRangeLimit should be defined.\n"
}

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

型: object

承認延長時間制限定義を終了時間として指定します。

ソースを表示

• timeExpires(required): string(date-time)
  RFC3339形式の日時文字列としての拡張有効期限。

{
    "type":"object",
    "required":[
        "timeExpires"
    ],
    "properties":{
        "timeExpires":{
            "type":"string",
            "format":"date-time",
            "description":"The extended expiration time as an RFC3339 formatted datetime string."
        }
    },
    "description":"Approval extension time limit definition as an end time."
}

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

型: array

承認タスクIDのリスト。

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"List of Approval Task ids.",
    "items":{
        "type":"string"
    }
}

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

型: object

時間範囲としての承認時間制限定義。

ソースを表示

• timeExpires(required): string(date-time)
  RFC3339形式の日時文字列としての有効期限。
• timeStarts(required): string(date-time)
  RFC3339形式の日時文字列としての開始時間。

{
    "type":"object",
    "required":[
        "timeExpires",
        "timeStarts"
    ],
    "properties":{
        "timeStarts":{
            "type":"string",
            "format":"date-time",
            "description":"The start time as an RFC3339 formatted datetime string."
        },
        "timeExpires":{
            "type":"string",
            "format":"date-time",
            "description":"The expiration time as an RFC3339 formatted datetime string."
        }
    },
    "description":"Approval time limit definition as a time range."
}

トップに戻る

レスポンス

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

• application/json

202レスポンス

タスク・ディシジョンを一括処理する作業リクエストを作成しました。

ヘッダー

• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。
• opc-work-request-id: string
  非同期リクエストに対するOracleで割り当てられた一意の識別子。 これを使用して、非同期操作のステータスを問い合せることができます。

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

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

トップに戻る

例

次の例は、承認タスクを一括で承認または否認する方法を示しています。 これは非同期操作であり、50を超える承認タスクを承認または却下するために使用します。 サンプル・コマンドを実行する前に、プレースホルダー値を実際の値に置き換えます。

タスクIDを一括で承認または否認する前に、次のAPIを実行して必要なデータをフェッチする必要があります:

• 承認のリスト - [GET] {BasePath}/approvals/{accessRequestId}または
• 承認(個人)のリスト - [GET] {BasePath}approvals/me

.

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "taskIds": [
    "3c344664-19b1-11f0-91b5-3e5b0e78e128",
    "1e56b095-3c16-11f0-8176-c2421adcf556",
    "xx56b095-3c16-11f0-8176-c2421adcxxxx",
    "xx344664-19b1-11f0-91b5-3e5b0e78xxxx",
    "5f9a2bc1-4d21-11f0-93b6-5c3b7a5e7d2b",
    "7a4c8d22-6b35-11f0-9c82-9b1f62a4d8c4",
    "2d5f8a73-8c49-11f0-8e41-8d5a3b7c9d1f",
    "4e6d9f84-9d5c-11f0-92a8-7c1b5d3e8a2c",
    "xx9d5c-11f0-92a8-7c1b5d3e8xxxx",
    "6b2f1a95-2e76-11f0-81b2-4e3d7a5c8d2b"
  ],
  "action": "APPROVE",
  "comment": "Bulk Approval"
}' \
 '<${service-instance-url}/access-governance/access-controls/20250331/approvals/workRequest>'

POSTリクエストの送信

${service-instance-url}/access-governance/access-controls/${version}/approvals/workRequest

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

{
  "taskIds": [
    "3c344664-19b1-11f0-91b5-3e5b0e78e128",
    "1e56b095-3c16-11f0-8176-c2421adcf556",
    "xx56b095-3c16-11f0-8176-c2421adcxxxx",
    "xx344664-19b1-11f0-91b5-3e5b0e78xxxx",
    "5f9a2bc1-4d21-11f0-93b6-5c3b7a5e7d2b",
    "7a4c8d22-6b35-11f0-9c82-9b1f62a4d8c4",
    "2d5f8a73-8c49-11f0-8e41-8d5a3b7c9d1f",
    "4e6d9f84-9d5c-11f0-92a8-7c1b5d3e8a2c",
    "xx9d5c-11f0-92a8-7c1b5d3e8xxxx",
    "6b2f1a95-2e76-11f0-81b2-4e3d7a5c8d2b"
  ],
  "action": "APPROVE",
  "comment": "Bulk Approval"
}

レスポンス・コードの例

204 OKレスポンスがレスポンス・ヘッダーにopc-work-request-idとともに表示されます。 /approvals/workRequest/{workRequestId}でこのIDを使用して、非同期一括承認タスクのステータスを確認します。

先頭に戻る