インターフェイス説明

ロールを更新します。

リクエストパラメータ

Action
  • データ型:String
  • 必須項目:はい
  • 説明:操作インターフェイス、必須。 パラメータ値:「UpdateRole」。
RoleName
  • データ型:String
  • 必須項目:はい
  • 説明: ロールの名称 使用できる文字数は最大 64 文字です。
  • 形式
    ^[a-zA-Z0-9\.
NewAssumeRolePolicyDocument
  • データ型:String
  • 必須項目:いいえ
  • 説明:ロールの ID を指定します。

リターンパラメータ

Role

必要な権限

Action
ram:UpdateRole
Resource
acs:ram:*:${AccountId}:role/*

エラーメッセージ

InvalidParameter.RoleName.InvalidChars
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「RoleName」に無効な文字が含まれています。
InvalidParameter.RoleName.Length
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「RoleName」は長さの制限を超えています。
InvalidParameter.NewAssumeRolePolicyDocument.Length
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「NewAssumeRolePolicyDocument」は長さの制限を超えています。
EntityNotExist.Role
  • HTTPステータスコード:404
  • エラーメッセージ:ロールは存在しません。
MalformedPolicyDocument
  • HTTPステータスコード: 400
  • エラーメッセージ:{エラーの詳細}

操作の例

リクエストの例
https://ram.aliyuncs.com/?Action=UpdateRole
&RoleName=ECSAdmin
&NewAssumeRolePolicyDocument=xxxx //TODO
&<Public request parameters>
戻り値の例
  • XML形式
    <UpdateRoleResponse>
        <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
        <Role>
            <RoleId>901234567890123</RoleId>
            <RoleName>ECSAdmin</RoleName>
            <Arn>acs:ram::1234567890123456:role/ECSAdmin</Arn>
            <Description>ECS Administrator role</Description>
            <AssumeRolePolicyDocument>{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "RAM": "acs:ram::123456789012345678:root" } } ], "Version": "1" }</AssumeRolePolicyDocument>
            <CreateDate>2015-01-23T12:33:18Z</CreateDate>
            <UpdateDate>2015-01-23T12:33:18Z</UpdateDate>
        </Role>
    </UpdateRoleResponse>
  • JSON形式
    
        "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
        "Role": {
            "RoleId": "901234567890123",
            "RoleName": "ECSAdmin",
            "Arn": "acs:ram::1234567890123456:role/ECSAdmin",
            "Description": "ECS Administrator role",
            "AssumeRolePolicyDocument": "{ \"Statement\": [ { \"Action\": \"sts:AssumeRole\", \"Effect\": \"Allow\", \"Principal\": { \"RAM\": \"acs:ram::123456789012345678:root\" } } ], \"Version\": \"1\" }",
            "CreateDate": "2015-01-23T12:33:18Z",
            "UpdateDate": "2015-01-23T12:33:18Z"
        }