インターフェイス説明

権限付与ポリシーのバージョンを取得します。

リクエストパラメータ

Action
  • データ型:String
  • 必須項目:はい
  • 説明:必須。 パラメータ値:「GetPolicyVersion」。
PolicyType
  • データ型:String
  • 必須項目:はい
  • 説明:権限付与ポリシーのタイプ。 値:「System」または「Custom」。
PolicyName
  • データ型:String
  • 必須項目:はい
  • 説明:権限付与ポリシーの名前。
VersionId
  • データ型:String
  • 必須項目:はい
  • 説明:ターゲットバージョンの ID。

リターンパラメータ

PolicyVersion

必要な権限

Action
ram:GetPolicyVersion
Resource
acs:ram:*:${AccountId} or system:group/${PolicyName}

エラーメッセージ

InvalidParameter.PolicyType
  • HTTPステータスコード:400
  • エラーメッセージ:パラメータ - 「PolicyType」は正しくありません。
InvalidParameter.PolicyName.InvalidChars
  • HTTPステータスコード:400
  • エラーメッセージ:パラメータ - 「PolicyName」に無効な文字が含まれています。
InvalidParameter.PolicyName.Length
  • HTTPステータスコード:400
  • エラーメッセージ:パラメータ - 「PolicyName」は長さの制限を超えています。
InvalidParameter.VersionId.Format
  • HTTPステータスコード:400
  • エラーメッセージ:パラメータ - 「VersionId」は正しくありません。
EntityNotExist.Policy
  • HTTPステータスコード:404
  • エラーメッセージ:ポリシーは存在しません。
EntityNotExist.Policy.Version
  • HTTPステータスコード:404
  • エラーメッセージ:ポリシーバージョンは存在しません。

操作の例

リクエストの例

https://ram.aliyuncs.com/?Action=GetPolicyVersion
&PolicyName=OSS-Administrator
&PolicyType=Custom
&VersionId=v3
&<Public request parameters>

戻り値の例

  • XML形式
    <GetPolicyVersionResponse>
        <RequestId>9B34724D-54B0-4A51-B34D-4512372FE1BE</RequestId>
        <PolicyVersion>
            <VersionId>v3</VersionId>
            <IsDefaultVersion>false</IsDefaultVersion>
            <CreateDate>2015-01-23T12:33:18Z</CreateDate>
            <PolicyDocument>
                
            </PolicyDocument>
        </PolicyVersion>
    </GetPolicyVersionResponse>
  • JSON形式
    
        "RequestId": "9B34724D-54B0-4A51-B34D-4512372FE1BE",
        "PolicyVersion": {
            "VersionId": "v3",
            "IsDefaultVersion": false,
            "CreateDate": "2015-01-23T12:33:18Z",
            "PolicyDocument": "{ \"Statement\": [{ \"Action\": [\"oss:*\"], \"Effect\": \"Allow\", \"Resource\": [\"acs:oss:*:*:*\"]}], \"Version\": \"1\"}"
        }