機械翻訳について

移動先

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

アカウントの取得

get

/access-governance/identities/20250331/identities/{identityId}/accounts/{accountId}

識別子でアカウントを取得します。

リクエスト

パス・パラメータ

• accountId(required): string
  一意のアカウントID。
• identityId(required): string
  一意のアイデンティティID。

ヘッダー・パラメータ

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

トップに戻る

レスポンス

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

• application/json

200レスポンス

指定されたアカウントIDのアカウントを取得します。

ヘッダー

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

本文()

ルート・スキーマ : AccessGovernanceEntity

型: object

Access Governanceエンティティ

ソースを表示

• entityType(required): string
  Access Governanceのエンティティ・タイプ
• id(必須): string
  Access GovernanceエンティティのID
• isRuleBased: boolean
  このアイデンティティはベースですか
• name(required): string
  アクセス・ガバナンス・タイプの名前
• timeCreated(required): string(日時)
  アクセス・ガバナンスによってエンティティが作成された時間
• timeUpdated(required): string(日時)
  エンティティがアクセス・ガバナンスによって最後に変更された時間
• type(必須): string
  許容値: [ "IDENTITY", "IDENTITY_COLLECTION", "ORGANIZATION", "ROLE", "PERMISSION", "ACCESS_BUNDLE", "POLICY", "RESOURCE", "CLOUD_RESOURCE", "ACCOUNT", "OWNERSHIP", "APPROVAL_PROCESS", "TARGET", "ACCESS_GUARDRAIL" ]

  アクセス・ガバナンスのエンティティ・タイプ
• value(required): string
  アクセス・ガバナンス・タイプのjsonスキーマ

{
    "type":"object",
    "required":[
        "entityType",
        "id",
        "name",
        "timeCreated",
        "timeUpdated",
        "type",
        "value"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The Id for Access Governance Entity"
        },
        "type":{
            "type":"string",
            "description":"The Access Governance Entity Type",
            "enum":[
                "IDENTITY",
                "IDENTITY_COLLECTION",
                "ORGANIZATION",
                "ROLE",
                "PERMISSION",
                "ACCESS_BUNDLE",
                "POLICY",
                "RESOURCE",
                "CLOUD_RESOURCE",
                "ACCOUNT",
                "OWNERSHIP",
                "APPROVAL_PROCESS",
                "TARGET",
                "ACCESS_GUARDRAIL"
            ],
            "x-obmcs-top-level-enum":"#/definitions/EntityType"
        },
        "name":{
            "type":"string",
            "description":"The name for Access Governance Type"
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"Time when entity was created by Access Governance"
        },
        "timeUpdated":{
            "type":"string",
            "format":"date-time",
            "description":"Time when entity was last modified by Access Governance"
        },
        "isRuleBased":{
            "type":"boolean",
            "description":"Is this identity ruled based"
        },
        "entityType":{
            "type":"string",
            "description":"The Entity type in Access Governance"
        },
        "value":{
            "type":"string",
            "description":"The json schema for Access Governance Type"
        }
    },
    "description":"An Access Governance Entity"
}

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

トップに戻る

例

次の例は、アカウント属性を含むアイデンティティ・アカウントの詳細を取得する方法を示しています。 アカウントIDとしてorchestratedSystemIdentityIdを使用します。

cURL GETの例

curl -i -X \
 GET \
 -H \
 "Authorization:Bearer <your access token>" \
 '${service-instance-url}/access-governance/identities/${versionId}/identities/${IdentityId}/accounts/${accountID}'

レスポンス・コードの例

次のレスポンス本文を含む200 OKレスポンス・コードを受け取ります:

{
  "id": "targetId.account.ICF.da7efca4-xxxx-4d4f-8ad3-c55ac9362de6.a285ce40190faf23401a9e2c3f35682c",
  "type": "ACCOUNT",
  "name": "Bill Clark",
  "timeCreated": "2024-11-08T11:22:55.789Z",
  "timeUpdated": "2024-11-08T11:22:55.789Z",
  "entityType": "ACCOUNT",
  "typeDetails": "https://database-access-management.api.access-governance.oci.oc-test.com/access-governance/identities/20250331/types/agcs.Account?orchestratedSystemId=da7efca4-xxxx-4d4f-8ad3-c55ac9362de6",
  "attributes": [
    {
      "name": "resourceName",
      "value": "Database Access Management"
    },
    {
      "name": "resourceTypeName",
      "value": "DBUM"
    },
    {
      "name": "connectedSystem",
      "value": "Database Access Management"
    },
    {
      "name": "targetType",
      "value": "ICF"
    },
    {
      "name": "targetId",
      "value": "da7efca4-xxxx-4d4f-8ad3-c55ac9362de6"
    }
  ],
  "value": "{\n  \"targetId\": \"da7efca4-xxxx-4d4f-8ad3-c55ac9362de6\",\n  \"identityGlobalId\": \"globalId.125123c3-xxxx-4d6a-b6d4-6c0f6537bad2.55045.02e36bbb4b201421b44aa046b3ceb16a\",\n  \"resourcesId\": \"resource.ICF.da7efca4-xxxx-4d4f-8ad3-c55ac9362de6.153c14344ccda28d2c2106cc5b5a8e4d\",\n  \"identityAccountType\": \"ACCOUNT\",\n  \"name\": \"Bill Clark\",\n  \"status\": \"true\",\n  \"riskSummary\": 0,\n  \"userLogin\": \"Bill Clark\",\n  \"customAttributes\": {\n    \"operationType\": \"CREATE_OR_UPDATE\",\n    \"authenticationType\": \"EXTERNAL\",\n    \"globalDN\": \"cn\\\\u003dBILLCLARK,cn\\\\u003dadmin,dc\\\\u003dcorp,dc\\\\u003dCOM\",\n    \"defaultTablespace\": \"USERS\",\n    \"temporaryTablespace\": \"TEMP\",\n    \"profileName\": \"DEFAULT\",\n    \"accountStatus\": \"OPEN\",\n    \"roles\": [\n      { \"element\": { \"UID\": \"DV_OWNER\", \"roleAdminOption\": \"NO\" } },\n      { \"element\": { \"UID\": \"DV_GOLDENGATE_REDO_ACCESS\", \"roleAdminOption\": \"NO\" } }\n    ]\n  },\n  \"id\": \"targetId.account.ICF.da7efca4-xxxx-4d4f-8ad3-c55ac9362de6.a285ce40190faf23401a9e2c3f35682c\",\n  \"externalId\": \"Bill Clark\",\n  \"schemas\": [],\n  \"meta\": {\n    \"resourceType\": \"ACCOUNT\",\n    \"created\": 1731064975789,\n    \"lastModified\": 1731064975789,\n    \"version\": \"1\",\n    \"location\": \"\"\n  }\n}"
}
  

先頭に戻る