インターフェイス説明

特定の権限付与ポリシーの情報を取得します。

リクエストパラメータ

Action
  • データ型:String
  • 必須項目:はい
  • 説明:必須。 パラメータ値:「GetPolicy」。
PolicyType
  • データ型:String
  • 必須項目:はい
  • 説明:権限付与ポリシーのタイプ。 値:「System」または「Custom」。
PolicyName
  • 名称:PolicyName
  • データ型:String
  • 必須項目:はい
  • 説明:権限付与ポリシーの名前。

リターンパラメータ

Policy

必要な権限

Action
ram:GetPolicy
Resource
acs:ram:*:${AccountId} or system:policy/${PolicyName}

エラーメッセージ

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

リクエストの例

Https://ram.aliyuncs.com /? Action = getpolicy
&PolicyName=OSS-Administrator
&<Public request parameters>

戻り値の例

  • XML形式
    <GetPolicyResponse>
        <RequestId>697852FB-50D7-44D9-9774-530C31EAC572</RequestId>
        <Policy>
            <PolicyName>OSS-Administrator</PolicyName>
            <PolicyType>Custom</PolicyType>
            <Description>OSS administrator permission</Description>
            <DefaultVersion>v1</DefaultVersion>
            <CreateDate>2015-01-23T12:33:18Z</CreateDate>
            <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
            <AttachmentCount>0</AttachmentCount>
        </Policy>
    </GetPolicyResponse>
  • JSON形式
    
        "RequestId": "697852FB-50D7-44D9-9774-530C31EAC572",
        "Policy": {
            "PolicyName": "OSS-Administrator",
            "PolicyType": "Custom",
            "Description": "OSS administrator permission",
            "DefaultVersion": "v1",
            "CreateDate": "2015-01-23T12:33:18Z",
            "UpdateDate": "2015-01-23T12:33:18Z",
            "AttachmentCount": 0
        }