機械翻訳について

移動先

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

拡張リクエストの作成

post

/access-governance/access-controls/20250331/accessRequests/extension

指定された詳細を持つアイデンティティの新しい拡張リクエストを作成します。

リクエスト

ヘッダー・パラメータ

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

本文()

新規拡張リクエストの詳細

ルート・スキーマ : CreateExtensionRequestDetails

型: object

新しいExtensionRequestに関する情報。

ソースを表示

• extensionDateInEpoch(required): integer(int64)
  エポック・タイムスタンプとして表されるリクエストされた拡張日
• justification(required): string
  拡張リクエストの作成理由
• processInstanceId(required): string
  拡張されているリクエストのプロセス・インスタンスID

{
    "type":"object",
    "required":[
        "extensionDateInEpoch",
        "justification",
        "processInstanceId"
    ],
    "properties":{
        "processInstanceId":{
            "type":"string",
            "description":"Process Instance id of the request being extended"
        },
        "extensionDateInEpoch":{
            "type":"integer",
            "format":"int64",
            "description":"Requested extension date represented as epoch timestamp"
        },
        "justification":{
            "type":"string",
            "description":"Justification for creating the extension request"
        }
    },
    "description":"The information about new ExtensionRequest."
}

トップに戻る

レスポンス

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

• application/json

200レスポンス

新しく作成された拡張リクエスト

ヘッダー

• etag: string
  オプティミスティックな同時実行性制御用。 `if-match`を参照してください。
• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : ExtensionRequest

型: object

ExtensionRequestの説明。

ソースを表示

• createdBy: string
  リクエストを作成したユーザー
• extensionDateInEpoch: integer(int64)
  エポック・タイムスタンプとして表されるリクエストされた拡張日
• id(必須): string
  拡張リクエストの作成で不変である一意のOracle ID (OCID)。
• justification: string
  拡張リクエストの作成または更新の理由
• processInstanceId: string
  拡張されているリクエストのプロセス・インスタンスID
• requestStatus: string
  拡張リクエストのステータス
• timeCreated: string(date-time)
  ExtensionRequestが作成された時間。 「An RFC3339」書式設定日時文字列
• timeUpdated: string(date-time)
  ExtensionRequestが最後に更新された時間。 「An RFC3339」書式設定日時文字列

{
    "type":"object",
    "required":[
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The Unique Oracle ID (OCID) that is immutable on creation of extension request."
        },
        "processInstanceId":{
            "type":"string",
            "description":"Process Instance id of the request being extended"
        },
        "extensionDateInEpoch":{
            "type":"integer",
            "format":"int64",
            "description":"Requested extension date represented as epoch timestamp"
        },
        "justification":{
            "type":"string",
            "description":"Justification for creating or updating the extension request"
        },
        "requestStatus":{
            "type":"string",
            "description":"Status of the extension request"
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"The time the the ExtensionRequest was created. An RFC3339 formatted datetime string"
        },
        "timeUpdated":{
            "type":"string",
            "format":"date-time",
            "description":"The time the the ExtensionRequest was last updated. An RFC3339 formatted datetime string"
        },
        "createdBy":{
            "type":"string",
            "description":"The user that created the request"
        }
    },
    "description":"Description of ExtensionRequest."
}

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

トップに戻る

例

次の例は、時間制限付きアクセスの拡張をリクエストする方法を示しています。 approvalRequestIDをEPOC形式のミリ秒でプロセス・インスタンスIDおよびタイムスタンプとして使用します。

拡張時間はアクセスの有効期限より後にする必要があります。 タイムスタンプには「EPOCコンバータ」を使用します。 拡張リクエストを作成する前に、approvalRequestIDをフェッチするためのアクセス・リクエストの詳細の取得を実行します。 アクセス・バンドルの構成では、拡張リクエストを許可する必要があり、承認ワークフローが関連付けられている必要があります。

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
    "processInstanceId": "25d5ed10-da3d-4405-8151-2ca90b7df645:0a2e2c08-3bb6-11f0-a9b2-728731956d82",
    "justification": "test extension request validation again",
    "extensionDateInEpoch": 1748446221000
}' \
 '<${service-instance-url}/access-governance/access-controls/${versionId}/accessRequests/extension>'

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

{
    "processInstanceId": "25d5ed10-da3d-4405-8151-2ca90b7df645:0a2e2c08-3bb6-11f0-a9b2-728731956d82",
    "justification": "test extension request validation again",
    "extensionDateInEpoch": 1750179992000
}

レスポンス・コードの例

アイデンティティ・コレクションの作成には数秒かかる場合があります。 リクエストを中断しないでください。

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

{
  "id": "5996aa34-825f-4569-xxx-a0b2c4b64c7a",
  "processInstanceId": "25d5ed10-da3d-4405-8151-2ca90b7df645:0a2e2c08-3bb6-11f0-a9b2-728731956d82",
  "extensionDateInEpoch": 1750179992000,
  "justification": "Extension till June 17 5:06:32 PM",
  "requestStatus": "APPROVED",
  "timeCreated": "2025-06-15T13:42:06.644Z",
  "timeUpdated": "2025-06-16T13:42:06.644Z",
  "createdBy": "clientId.External.88b9690ece344xxx53570480031e7d0"
}

拡張リクエストの承認リクエストは、元のアクセス・リクエストIDに関連付けられます。 GET accessRequests/{accessRequestId}を実行して、アクセス・リクエストの詳細を取得できます。

先頭に戻る