インターフェイス説明
ロールを更新します。
リクエストパラメータ
Action- データ型:String
- 必須項目:はい
- 説明:操作インターフェイス、必須。 パラメータ値:「UpdateRole」。
- データ型:String
- 必須項目:はい
- 説明: ロールの名称 使用できる文字数は最大 64 文字です。
- 形式
^[a-zA-Z0-9\.
- データ型:String
- 必須項目:いいえ
- 説明:ロールの ID を指定します。
リターンパラメータ
Role- データ型:ロール(Role)
- 説明: ロールの情報。
必要な権限
Action
ram:UpdateRole
Resourceacs:ram:*:${AccountId}:role/*
エラーメッセージ
InvalidParameter.RoleName.InvalidChars- HTTPステータスコード: 400
- エラーメッセージ:パラメータ - 「RoleName」に無効な文字が含まれています。
- HTTPステータスコード: 400
- エラーメッセージ:パラメータ - 「RoleName」は長さの制限を超えています。
- HTTPステータスコード: 400
- エラーメッセージ:パラメータ - 「NewAssumeRolePolicyDocument」は長さの制限を超えています。
- HTTPステータスコード:404
- エラーメッセージ:ロールは存在しません。
- 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" }