機械翻訳について

移動先

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

アクセス・ガードレールの分析

post

/access-governance/access-controls/20250331/accessGuardrails/analyze

あらゆる違反に対するアイデンティティ。

リクエスト

ヘッダー・パラメータ

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

本文()

アクセス・ガードレール分析の詳細。

ルート・スキーマ : AnalyzeAccessGuardrailsDetails

型: object

アイデンティティに対するアクセス・ガードレールを分析するためのリクエスト本文。

ソースを表示

• accessGuardrailIds: array accessGuardrailIds
  ガードレールIDにアクセスします。
• globalIdentityIds(required): array globalIdentityIds
  グローバル・アイデンティティ。

{
    "type":"object",
    "required":[
        "globalIdentityIds"
    ],
    "properties":{
        "globalIdentityIds":{
            "type":"array",
            "description":"Global Identity Ids.",
            "items":{
                "type":"string"
            }
        },
        "accessGuardrailIds":{
            "type":"array",
            "description":"Access Guardrail Ids.",
            "items":{
                "type":"string"
            }
        }
    },
    "description":"Request Body for analyzing Access Guardrails against Identities."
}

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

型: array

ガードレールIDにアクセスします。

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"Access Guardrail Ids.",
    "items":{
        "type":"string"
    }
}

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

型: array

グローバル・アイデンティティ。

ソースを表示

• Array of: string

{
    "type":"array",
    "description":"Global Identity Ids.",
    "items":{
        "type":"string"
    }
}

トップに戻る

レスポンス

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

• application/json

200レスポンス

アクセス・ガードレール分析は正常に完了しました。

ヘッダー

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

本文()

ルート・スキーマ : AnalyzeAccessGuardrailsResult

型: object

アイデンティティに対するアクセス・ガードレールを分析するためのレスポンス本文。

ソースを表示

• items(必須): array items
  各グローバル・アイデンティティIDに対応する違反の詳細。
• violationCount(required): integer
  violationCount.

{
    "type":"object",
    "required":[
        "items",
        "violationCount"
    ],
    "properties":{
        "violationCount":{
            "type":"integer",
            "description":"violationCount."
        },
        "items":{
            "type":"array",
            "description":"Violation details corresponding to each global identity id.",
            "items":{
                "$ref":"#/definitions/AnalyzeAccessGuardrailsViolationDetails"
            }
        }
    },
    "description":"Response body for analyzing Access Guardrails against Identities."
}

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

型: array

各グローバル・アイデンティティIDに対応する違反の詳細。

ソースを表示

• Array of: object AnalyzeAccessGuardrailsViolationDetails
  アクセス・ガードレール違反詳細の分析

{
    "type":"array",
    "description":"Violation details corresponding to each global identity id.",
    "items":{
        "$ref":"#/definitions/AnalyzeAccessGuardrailsViolationDetails"
    }
}

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

型: object

アクセス・ガードレール違反詳細の分析

ソースを表示

• accessGuardrailId: string
  accessGuardrailId
• globalIdentityId(required): string
  globalIdentityId
• hasViolation(required): boolean
  hasViolation
• violationDetails: object violationDetails
  許可される追加のプロパティ: additionalProperties

  キーが一意のルール識別子を表し、値が違反のリストであるマップ。

{
    "type":"object",
    "required":[
        "globalIdentityId",
        "hasViolation"
    ],
    "properties":{
        "globalIdentityId":{
            "type":"string",
            "description":"globalIdentityId"
        },
        "hasViolation":{
            "type":"boolean",
            "description":"hasViolation"
        },
        "accessGuardrailId":{
            "type":"string",
            "description":"accessGuardrailId"
        },
        "violationDetails":{
            "type":"object",
            "description":"A map where keys represent unique rule identifiers and values are lists of violations.",
            "additionalProperties":{
                "type":"array",
                "items":{
                    "type":"string"
                }
            }
        }
    },
    "description":"Analyze Access Guardrails Violation details"
}

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

型: object

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

ソースを表示

• array additionalProperties

{
    "type":"object",
    "description":"A map where keys represent unique rule identifiers and values are lists of violations.",
    "additionalProperties":{
        "type":"array",
        "items":{
            "type":"string"
        }
    }
}

キーが一意のルール識別子を表し、値が違反のリストであるマップ。

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

型: array

ソースを表示

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

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

412レスポンス

事前条件は失敗しました

ヘッダー

• 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}/accessGuardrails
• アイデンティティのリスト - [GET] {BasePath}/identities

.

cURLリクエストの例

curl -i -X POST \
   -H "Authorization:Bearer <your-access-token>" \
   -H "Content-Type:application/json" \
   -d \
'{
  "globalIdentityIds": [
    "globalId.OCI.bd49ff2a-5c47-4242-xxxx-9ba235fbb0ec.9fxxx61d84394960469c2af598b63d4"
  ],
  "accessGuardrailIds": [
    "a4203401-46c3-4xxx-891a-b1c127fa94ba"
  ]
}' \
 '<${service-instance-url}/access-governance/access-controls/20250331/accessGuardrails/analyze>'

POSTリクエストの送信

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

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

{
  "globalIdentityIds": [
    "globalId.OCI.bd49ff2a-5c47-4242-xxxx-9ba235fbb0ec.9fxxx61d84394960469c2af598b63d4"
  ],
  "accessGuardrailIds": [
    "a4203401-46c3-4xxx-891a-b1c127fa94ba"
  ]
}

レスポンス・コードの例

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

{
  "violationCount" : 1,
  "items" : [ {
    "globalIdentityId" : "globalId.OCI.bd49ff2a-5c47-4242-xxxx-9ba235fbb0ec.9fxxx61d84394960469c2af598b63d4",
    "hasViolation" : true,
    "accessGuardrailId" : "a4203401-46c3-xxx-891a-b1c127fa94ba",
    "violationDetails" : {
      "47beef27-b07a-497e-xxxx-765fbba966aa" : [ "This Identity does not have identity attribute Organization equals MK_Org_01" ]
    }
  } ]
}

先頭に戻る