機械翻訳について

移動先

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

承認タスクの取得

get

/access-governance/access-controls/20250331/approvals/{taskId}

指定されたIDを持つ承認タスクの詳細を返します。

リクエスト

パス・パラメータ

• taskId(required): string
  一意の承認タスク識別子。

ヘッダー・パラメータ

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

トップに戻る

レスポンス

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

• application/json

200レスポンス

承認タスクの詳細。

ヘッダー

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

本文()

ルート・スキーマ: Task

型: object

プロセス・インスタンス・タスクの詳細。

ソースを表示

• assignee: string
  タスクに割り当てられているユーザー。
• context: object InstanceContext
  プロセス・インスタンスに関連するコンテキスト・データ。
• id(必須): string
  BPMNプロバイダが提供するタスクの一意の識別子。
• instanceId: string
  プロセス・インスタンスID
• lastAction: object TaskAction
  特定のタスクに対して実行できるアクション。
• processId: string
  プロセス定義ID
• requestId: string
  コール元によって生成されるリクエストID。
• status: string
  許容値: [ "PENDING_APPROVAL", "APPROVED", "ASSIGNED", "MODIFIED", "REJECTED", "REMOVED", "DELETED", "INFO_REQUESTED", "ESCALATED", "ERROR", "CANCELLED" ]

  タスクのステータスです。
• timeCompleted: string(date-time)
  タスクの完了日。
• timeCreated: string(date-time)
  タスクの作成日。
• timeDue: string(date-time)
  タスクの期日。

{
    "type":"object",
    "required":[
        "id"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"Unique identifier of the task provided by BPMN provider."
        },
        "processId":{
            "type":"string",
            "description":"Process definition ID."
        },
        "instanceId":{
            "type":"string",
            "description":"Process instance ID."
        },
        "requestId":{
            "type":"string",
            "description":"Request ID which is generated by the caller."
        },
        "assignee":{
            "type":"string",
            "description":"User who is assigned to the task."
        },
        "status":{
            "type":"string",
            "description":"The status of the task.",
            "enum":[
                "PENDING_APPROVAL",
                "APPROVED",
                "ASSIGNED",
                "MODIFIED",
                "REJECTED",
                "REMOVED",
                "DELETED",
                "INFO_REQUESTED",
                "ESCALATED",
                "ERROR",
                "CANCELLED"
            ],
            "x-obmcs-top-level-enum":"#/definitions/TaskStatus"
        },
        "lastAction":{
            "$ref":"#/definitions/TaskAction"
        },
        "context":{
            "$ref":"#/definitions/InstanceContext"
        },
        "timeDue":{
            "type":"string",
            "format":"date-time",
            "description":"The due date of the task."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"The creation date of the task."
        },
        "timeCompleted":{
            "type":"string",
            "format":"date-time",
            "description":"The completion date of the task."
        }
    },
    "description":"The details of a process instance task."
}

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

型: object

プロセス・インスタンスに関連するコンテキスト・データ。

ソースを表示

• additionalAttributes: object additionalAttributes
  許可される追加のプロパティ: additionalProperties

  追加キーと値文字列のペアをマップします。
• assignmentAttributes: object assignmentAttributes
  許可される追加のプロパティ: additionalProperties

  追加キーと値文字列のペアをマップします。
• assignmentDescription: string
  リクエストされているアサイメントの摘要。
• assignmentName: string
  リクエストされているアサイメントの名前。
• assignmentTags: array assignmentTags
  割当タグ。
• assignmentType: string
  リクエストされるアサイメントのタイプ。
• beneficiary: string
  プロセス・インスタンス受取人の表示名。
• instanceVariables: array instanceVariables
  クライアント固有のコンテキスト。
• justification: string
  リクエストの理由。
• message: string
  相関メッセージ名。
• requestor: string
  プロセス・インスタンス・リクエスタの表示名。
• timeCreated: string(date-time)
  プロセス・インスタンスの作成日。
• timers: array timers
  更新するタイマー。

{
    "type":"object",
    "properties":{
        "requestor":{
            "type":"string",
            "description":"Display name of the process instance requestor."
        },
        "beneficiary":{
            "type":"string",
            "description":"Display name of the process instance beneficiary."
        },
        "assignmentName":{
            "type":"string",
            "description":"Name of the assignment that is being requested."
        },
        "assignmentType":{
            "type":"string",
            "description":"Type of the assignment that is being requested."
        },
        "assignmentDescription":{
            "type":"string",
            "description":"Description of the assignment that is being requested."
        },
        "assignmentAttributes":{
            "type":"object",
            "description":"Map for additional key, value string pairs.",
            "additionalProperties":{
                "type":"object",
                "properties":{
                }
            }
        },
        "additionalAttributes":{
            "type":"object",
            "description":"Map for additional key, value string pairs.",
            "additionalProperties":{
                "type":"string"
            }
        },
        "assignmentTags":{
            "type":"array",
            "description":"Assignment tags.",
            "items":{
                "type":"string",
                "enum":[
                    "SOD_VIOLATIONS",
                    "EXPIRES_SOON",
                    "EXTENSION_REQUEST"
                ],
                "x-obmcs-top-level-enum":"#/definitions/InstanceTags"
            }
        },
        "justification":{
            "type":"string",
            "description":"Reason for the request."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"The creation date of the process instance."
        },
        "instanceVariables":{
            "type":"array",
            "description":"Client specific context.",
            "items":{
                "$ref":"#/definitions/InstanceVariable"
            }
        },
        "message":{
            "type":"string",
            "description":"Correlation message name."
        },
        "timers":{
            "type":"array",
            "description":"Timers to update.",
            "items":{
                "$ref":"#/definitions/InstanceTimer"
            }
        }
    },
    "description":"Context data pertaining to the process instance."
}

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

型: object

特定のタスクに対して実行できるアクション。

ソースを表示

• action(required): string
  許容値: [ "REQUEST_INFO", "PROVIDE_INFO", "APPROVE", "MODIFY", "REASSIGN", "ASSIGN", "REMOVE", "REJECT", "CANCEL", "EXTENSION_REQUEST", "EXPIRE", "ACCESS_REQUEST" ]

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

  承認時間制限タイプ。
• comment: string
  処理の事由。
• extensionTimeLimit: object ExtensionTimeLimit
  承認延長時間制限定義を終了時間として指定します。
• id: string
  タスク処理の一意識別子。
• parentId: string
  親処理の識別子(存在する場合)。
• timeCreated: string(date-time)
  タスクの作成日。
• user: string
  アクションを実行しているユーザー。

{
    "type":"object",
    "required":[
        "action"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"Unique identifier of the task action."
        },
        "parentId":{
            "type":"string",
            "description":"Identifier of the parent action, if one exists."
        },
        "action":{
            "type":"string",
            "description":"The action type.",
            "enum":[
                "REQUEST_INFO",
                "PROVIDE_INFO",
                "APPROVE",
                "MODIFY",
                "REASSIGN",
                "ASSIGN",
                "REMOVE",
                "REJECT",
                "CANCEL",
                "EXTENSION_REQUEST",
                "EXPIRE",
                "ACCESS_REQUEST"
            ],
            "x-obmcs-top-level-enum":"#/definitions/TaskActionType"
        },
        "user":{
            "type":"string",
            "description":"User who is performing the action."
        },
        "comment":{
            "type":"string",
            "description":"Reason for the action."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"The creation date of the task."
        },
        "approvalTimeLimitType":{
            "type":"string",
            "description":"The approval time limit type.",
            "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 action which can be performed for a given task."
}

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

型: object

使用可能なその他のプロパティ

ソースを表示

• string

{
    "type":"object",
    "description":"Map for additional key, value string pairs.",
    "additionalProperties":{
        "type":"string"
    }
}

追加キーと値文字列のペアをマップします。

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

型: object

使用可能なその他のプロパティ

ソースを表示

• object additionalProperties

{
    "type":"object",
    "description":"Map for additional key, value string pairs.",
    "additionalProperties":{
        "type":"object",
        "properties":{
        }
    }
}

追加キーと値文字列のペアをマップします。

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

型: array

割当タグ。

ソースを表示

• Array of: string
  許容値: [ "SOD_VIOLATIONS", "EXPIRES_SOON", "EXTENSION_REQUEST" ]

{
    "type":"array",
    "description":"Assignment tags.",
    "items":{
        "type":"string",
        "enum":[
            "SOD_VIOLATIONS",
            "EXPIRES_SOON",
            "EXTENSION_REQUEST"
        ],
        "x-obmcs-top-level-enum":"#/definitions/InstanceTags"
    }
}

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

型: array

クライアント固有のコンテキスト。

ソースを表示

• Array of: object InstanceVariable
  プロセス・インスタンスの変数

{
    "type":"array",
    "description":"Client specific context.",
    "items":{
        "$ref":"#/definitions/InstanceVariable"
    }
}

ネストされたスキーマ : タイマー

型: array

更新するタイマー。

ソースを表示

• Array of: object InstanceTimer
  プロセス・インスタンスのタイマー

{
    "type":"array",
    "description":"Timers to update.",
    "items":{
        "$ref":"#/definitions/InstanceTimer"
    }
}

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

型: object

ソースを表示

{
    "type":"object",
    "properties":{
    }
}

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

型: object

プロセス・インスタンスの変数

ソースを表示

• name: string
  変数名
• value: object value
  変数に割り当てられた値
• valuetype: string
  変数の値タイプ。 string、boolean、integer、long、doubleを使用できます

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"variable name"
        },
        "value":{
            "type":"object",
            "description":"value assigned to the variable",
            "properties":{
            }
        },
        "valuetype":{
            "type":"string",
            "description":"The value type of the variable. It can be string, boolean, integer, long , double"
        }
    },
    "description":"Variable of process instance"
}

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

型: object

変数に割り当てられた値

ソースを表示

{
    "type":"object",
    "description":"value assigned to the variable",
    "properties":{
    }
}

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

型: object

プロセス・インスタンスのタイマー

ソースを表示

• id: string
  タイマーID
• value: string
  タイマー値

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Timer id"
        },
        "value":{
            "type":"string",
            "description":"Timer value"
        }
    },
    "description":"Timers of process instance"
}

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

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

トップに戻る

例

次の例は、特定の承認タスクの詳細を取得する方法を示しています。

cURLリクエストの例

curl -i -X GET \
   -H "Authorization:Bearer <your access token>" \
 'https://<host>/access-governance/access-controls/20250331/approvals/${approvaltaskID}'

レスポンス・コードの例

次のレスポンス本文とともに200 OKレスポンスを受け取ります:

{
  "id" : "d7ca9xxx-xxxx-11f0-a4f0-ce0355309xxx",
  "processId" : "Guid_18220xxx-a280-4c64-a4b7-e00fb4axxxxx",
  "instanceId" : "ae3a3xxx-5fbe-4503-bdea-67ea84xxx4114b:d60b0xxx-1efa-11f0-bd85-ba97ac6xxxxx",
  "requestId" : "d2756xxx-0deb-4a90-bd2a-a31f13xxxxx",
  "assignee" : "Betty Cook",
  "status" : "PENDING APPROVAL",
  "lastAction" : null,
  "context" : {
    "requestor" : "Amel Maclead",
    "beneficiary" : "Bill Clark",
    "assignmentName" : "DBUM-Access-Bundle-Request",
    "assignmentType" : "DBUM_ACCESS_BUNDLE",
    "assignmentDescription" : "Request for Database User Management Access Bundle",
    "assignmentAttributes" : null,
    "assignmentTags" : [ ],
    "timeOfExpiration" : null,
    "justification" : "Requesting DBUM basic privileges",
    "timeCreated" : "2025-04-21T21:51:53.008Z",
    "instanceVariables" : null,
    "message" : null,
    "timers" : null
  },
  "timeDue" : "2025-04-28T21:51:55.953Z",
  "timeCreated" : "2025-04-21T21:51:55.952Z",
  "timeCompleted" : null
} 

先頭に戻る