機械翻訳について

移動先

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

ポリシー・ステートメントのリソース数のサマリーをリスト

get

/access-governance/access-reviews/20250331/accessReviews/{accessReviewId}/policyStatements/{policyStatementId}/resourceCounts

ポリシー・アクセス・レビューのポリシー・ステートメントのリソース数サマリーを返します。

リクエスト

パス・パラメータ

• accessReviewId(required): string
  一意のアクセス・レビュー識別子。
• policyStatementId(required): string
  一意のポリシー・ステートメント識別子。

問合せパラメータ

• groupBy(required): string
  ポリシー・リソースのグループ化フィールド。

  許容値: [ "type" ]
• limit: integer
  最小値: 1

  最大値: 1000

  返されるアイテムの最大数。

  デフォルト値: 10
• page: string
  最小長: 1

  結果の取得を開始する位置を表すトークン。 これは、前のレスポンスの`opc-next-page`ヘッダー・フィールドから取得する必要があります。
• sortOrder: string
  使用するソート順(ASCまたはDESC)。

  許容値: [ "ASC", "DESC" ]
• type: string
  リソース・ディメンション・タイプのパラメータ。 デフォルト値はRESOURCE_TYPEです。

  デフォルト値: RESOURCE_TYPE

  許容値: [ "RESOURCE_TYPE", "COMPARTMENT" ]

ヘッダー・パラメータ

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

トップに戻る

レスポンス

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

• application/json

200レスポンス

指定されたポリシーのポリシー・ステートメントの詳細。

ヘッダー

• opc-next-page: string
  アイテム・リストのページ区切り。 リストをページングする際、このヘッダーがレスポンスに表示される場合は、部分的なリストが返されている可能性があります。 この値を後続のGETリクエストの`page`パラメータとして含め、次のアイテム・バッチを取得します。
• opc-request-id: string
  リクエストに対するOracleで割り当てられた一意の識別子。 特定のリクエストについてOracleに連絡する必要がある場合は、リクエストIDを指定してください。

本文()

ルート・スキーマ : ResourceAggregationSummaryCollection

型: object

レビュー集計のリスト。

ソースを表示

• items(必須): array items
  レビュー集計のリスト。

{
    "type":"object",
    "description":"List of review aggregations.",
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of review aggregations.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/ResourceAggregationSummary"
            }
        }
    }
}

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

型: array

レビュー集計のリスト。

ソースを表示

• Array of: object ResourceAggregationSummary
  レビューに基づく集計。

{
    "description":"List of review aggregations.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/ResourceAggregationSummary"
    }
}

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

型: object

レビューに基づく集計。

ソースを表示

• count(必須): integer
  集計の一致数。
• dimension(required): object ResourceDimension
  集計対象のディメンション。

{
    "type":"object",
    "description":"The aggregation based on the reviews.",
    "required":[
        "dimension",
        "count"
    ],
    "properties":{
        "dimension":{
            "$ref":"#/definitions/ResourceDimension"
        },
        "count":{
            "description":"The count of matches for the aggregation.",
            "type":"integer"
        }
    }
}

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

型: object

集計対象のディメンション。

ソースを表示

• fullValue: string
  値は、ResourceDimensionTypeコンパートメントのコンパートメントのフルネームを表します。それ以外の場合は、nullまたは値と同じです。
• value(required): string
  値はResourceDimensionTypeに基づく名前を表します。たとえば - resource_typeは、テスト・コンパートメントなどのコンパートメント名などのコンピュート、データベースなどです。

{
    "type":"object",
    "description":"The dimensions that are being aggregated on.",
    "required":[
        "value"
    ],
    "properties":{
        "value":{
            "type":"string",
            "description":"Value represents the name based on ResourceDimensionType For example - resource_type like computes, databases etc. compartment names like test-compartment etc."
        },
        "fullValue":{
            "type":"string",
            "description":"Value represents the full name of compartment for ResourceDimensionType compartment, for other it will null or same as value."
        }
    }
}

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

トップに戻る

例

次の例は、ポリシー・アクセス制御レビュー・タスクでポリシー・ステートメントのリソース数サマリーを取得する方法を示しています。 ポリシーのアクセス制御レビュー・タスクID、ポリシー・ステートメントIDを使用して、ポリシーに含まれるリソース数を取得します。

cURLの例

curl -i -X GET \
   -H "Authorization:Bearer <your access token>" \
 '${service-instance-url}/access-governance/access-reviews/accessReviews/${accessReviewId}/policyStatements/${policyStatementId}/resourceCounts

レスポンス本文の例

JSON形式のレスポンス本文のコンテンツの例を次に示します。

{
  "items": [
    {
      "dimension": {
        "value": "ROUTETABLE",
        "fullValue": null
      },
      "count": 2
    },
    {
      "dimension": {
        "value": "SECURITYLIST",
        "fullValue": null
      },
      "count": 2
    },
    {
      "dimension": {
        "value": "SUBNET",
        "fullValue": null
      },
      "count": 2
    },
    {
      "dimension": {
        "value": "DHCPOPTIONS",
        "fullValue": null
      },
      "count": 1
    },
    {
      "dimension": {
        "value": "INTERNETGATEWAY",
        "fullValue": null
      },
      "count": 1
    },
    {
      "dimension": {
        "value": "NATGATEWAY",
        "fullValue": null
      },
      "count": 1
    },
    {
      "dimension": {
        "value": "PUBLICIP",
        "fullValue": null
      },
      "count": 1
    },
    {
      "dimension": {
        "value": "SERVICEGATEWAY",
        "fullValue": null
      },
      "count": 1
    },
    {
      "dimension": {
        "value": "VCN",
        "fullValue": null
      },
      "count": 1
    }
  ]
} 

先頭に戻る