機械翻訳について

移動先

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

1つ以上の承認タスクを処理します。

post

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

リクエスト

ヘッダー・パラメータ

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

本文()

1つ以上の承認タスク・ディシジョン。

ルート・スキーマ : ApprovalDecisionDetails

型: object

承認タスク・ディシジョンのリスト。

ソースを表示

• decisions(required): array decisions
  承認タスク・ディシジョンのリスト。

{
    "type":"object",
    "required":[
        "decisions"
    ],
    "properties":{
        "decisions":{
            "type":"array",
            "description":"List of Approval Task decisions.",
            "items":{
                "$ref":"#/definitions/ApprovalDecision"
            }
        }
    },
    "description":"A list of Approval Task decisions."
}

ネストされたスキーマ : ディシジョン

型: array

承認タスク・ディシジョンのリスト。

ソースを表示

• Array of: object ApprovalDecision
  個々の承認タスクのディシジョン。

{
    "type":"array",
    "description":"List of Approval Task decisions.",
    "items":{
        "$ref":"#/definitions/ApprovalDecision"
    }
}

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

型: object

個々の承認タスクのディシジョン。

ソースを表示

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

  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
  承認延長時間制限定義を終了時間として指定します。
• taskId(required): string
  ディシジョンの承認タスクID。

{
    "type":"object",
    "required":[
        "action",
        "comment",
        "taskId"
    ],
    "properties":{
        "taskId":{
            "type":"string",
            "description":"The Approval Task ID for the decision."
        },
        "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":"An individual Approval Task decision."
}

ネストされたスキーマ : 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."
}

ネストされたスキーマ : 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

200レスポンス

承認タスクの一部またはすべてが正常に更新されました。

ヘッダー

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

本文()

ルート・スキーマ : ApprovalDecisionResults

型: object

一連の承認タスク・ディシジョンのレスポンス詳細。

ソースを表示

• failures(required): array failures
  タスク処理の作成中に生成された失敗のリスト。
• status: string
  リクエストの全体ステータス。

{
    "type":"object",
    "required":[
        "failures"
    ],
    "properties":{
        "status":{
            "type":"string",
            "description":"Overall status of request."
        },
        "failures":{
            "type":"array",
            "description":"List of failures generated while creating task actions.",
            "items":{
                "$ref":"#/definitions/ApprovalDecisionFailure"
            }
        }
    },
    "description":"Response details of a set of Approval Task decisions."
}

ネストされたスキーマ : 失敗

型: array

タスク処理の作成中に生成された失敗のリスト。

ソースを表示

• Array of: object ApprovalDecisionFailure
  承認タスク・ディシジョンの失敗詳細。

{
    "type":"array",
    "description":"List of failures generated while creating task actions.",
    "items":{
        "$ref":"#/definitions/ApprovalDecisionFailure"
    }
}

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

型: object

承認タスク・ディシジョンの失敗詳細。

ソースを表示

• errorMessage: string
  エラーの原因。
• taskId(required): string
  更新に失敗したタスクの一意の識別子。

{
    "type":"object",
    "required":[
        "taskId"
    ],
    "properties":{
        "taskId":{
            "type":"string",
            "description":"Unique identifier of the task which failed to update."
        },
        "errorMessage":{
            "type":"string",
            "description":"Cause of the error."
        }
    },
    "description":"Failure details of an Approval Task decision."
}

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

トップに戻る

例

次の例は、リクエスト・タスクの承認タスクを承認または否認する方法を示しています。 サンプル・コマンドを実行する前に、プレースホルダー値を実際の値に置き換えます。

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

• 承認のリスト - [GET] {BasePath}/approvals/{accessRequestId}
• アイデンティティのリスト - [GET] {BasePath}/identities

.

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
    "decisions": [
        {
            "taskId": "62555a75-30da-xxxxx-997d-xxxx",
            "action": "APPROVE",
            "comment": "Needed to perform the job"
        }
    ]
}' \
 '<${service-instance-url}/access-governance/access-controls/20250331/approvals>'

POSTリクエストの送信

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

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

{
    "decisions": [
        {
            "taskId": "62555a75-30da-xxxxx-997d-xxxx",
            "action": "APPROVE",
            "comment": "Needed to perform the job"
        }
    ]
}

レスポンス・コードの例

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

{ "failures": [] }

先頭に戻る