GetPolicyOptions

authorizationPolicies.getIamPolicy に指定された設定をカプセル化します。

JSON 表現 
{
  "requestedPolicyVersion": integer
}
フィールド
requestedPolicyVersion

integer

省略可。ポリシーの形式設定に使用されるポリシーの最大バージョン。

有効な値は 0、1、3 です。無効な値を指定したリクエストは拒否されます。

条件付きロール バインディングがあるポリシーのリクエストでは、バージョン 3 を指定する必要があります。条件付きロール バインディングがないポリシーでは、有効な値を指定することも、フィールドを設定しないこともできます。

レスポンスのポリシーでは、指定したポリシー バージョンを使用するか、それより低いポリシー バージョンを使用する場合があります。たとえば、バージョン 3 を指定しても、ポリシーに条件付きロール バインディングがない場合、レスポンスではバージョン 1 が使用されます。

IAM ポリシーで条件をサポートするリソースについては、IAM のドキュメントをご覧ください。