インターフェイス説明

ロールを更新します。

リクエストパラメータ

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