調用UpdateRole更新RAM角色信息。

本文將提供一個示例，更新RAM角色ECSAdmin的描述信息為ECS管理員。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 UpdateRole

要執行的操作。取值：UpdateRole。
RoleName String 是 ECSAdmin

RAM角色名稱。

長度為1~64個字符，可包含英文字母、數字、半角句號（.）和短劃線（-）。
NewAssumeRolePolicyDocument String 否 { "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "RAM": "acs:ram::12345678901234****:root" } } ], "Version": "1" }

RAM角色的信任策略。
NewMaxSessionDuration Long 否 3600

RAM角色最大會話時間。

取值范圍：3600秒~43200秒。默認值：3600秒。

取值為空時將采用默認值。
NewDescription String 否 ECS管理員

RAM角色描述。

長度為1~1024個字符。

關于公共請求參數的詳情，請參見公共參數。

返回數據

名稱 類型 示例值 描述
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

請求ID。
Role Struct

RAM角色信息。
Arn String acs:ram::123456789012****:role/ECSAdmin

RAM角色的資源描述符。
AssumeRolePolicyDocument String { \"Statement\": [ { \"Action\": \"sts:AssumeRole\", \"Effect\": \"Allow\", \"Principal\": { \"RAM\": \"acs:ram::12345678901234****:root\" } } ], \"Version\": \"1\" }

RAM角色的信任策略。
CreateDate String 2015-01-23T12:33:18Z

RAM角色創建時間。
Description String ECS管理角色

RAM角色描述。
MaxSessionDuration Long 3600

RAM角色最大會話時間。
RoleId String 90123456789****

RAM角色ID。
RoleName String ECSAdmin

RAM角色名稱。
RolePrincipalName String ECSAdmin@role.123456.onaliyunservice.com

被授權RAM角色名稱。
UpdateDate String 2016-01-23T12:33:18Z

RAM角色更新時間。

示例

請求示例

https://resourcemanager.aliyuncs.com/?Action=UpdateRole
&RoleName=ECSAdmin
&NewDescription=ECS管理角色
&<公共請求參數>

正常返回示例

XML格式 

<UpdateRoleResponse>
	  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
	  <Role>
		    <RoleId>90123456789****</RoleId>
		    <RoleName>ECSAdmin</RoleName>
		    <RolePrincipalName>ECSAdmin@role.123456.onaliyunservice.com</RolePrincipalName>
		    <Arn>acs:ram::123456789012****:role/ECSAdmin</Arn>
		    <Description>ECS管理角色</Description>
            <MaxSessionDuration>3600</MaxSessionDuration>
		    <AssumeRolePolicyDocument>{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "RAM": "acs:ram::12345678901234****:root" } } ], "Version": "1" }</AssumeRolePolicyDocument>
		    <CreateDate>2015-01-23T12:33:18Z</CreateDate>
		    <UpdateDate>2016-01-23T12:33:18Z</UpdateDate>
	  </Role>
</UpdateRoleResponse>

JSON格式 

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "Role": {
        "RoleId": "90123456789****",
        "RoleName": "ECSAdmin",
        "RolePrincipalName": "ECSAdmin@role.123456.onaliyunservice.com",
        "Arn": "acs:ram::123456789012****:role/ECSAdmin",
        "Description": "ECS管理角色",
        "MaxSessionDuration": 3600,
        "AssumeRolePolicyDocument": "{ \"Statement\": [ { \"Action\": \"sts:AssumeRole\", \"Effect\": \"Allow\", \"Principal\": { \"RAM\": \"acs:ram::12345678901234****:root\" } } ], \"Version\": \"1\" }",
        "CreateDate": "2015-01-23T12:33:18Z",
        "UpdateDate": "2016-01-23T12:33:18Z"
    }
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidParameter.RoleName.InvalidChars The specified role name contains invalid characters. 角色名稱包含無效字符。
400 InvalidParameter.RoleName.Length The maximum length of the role name is exceeded. 角色名稱長度超出限制。
400 InvalidParameter.NewAssumeRolePolicyDocument.Length The maximum length of the new trust policy document of the role is exceeded. 新角色信任策略長度超出限制。
404 EntityNotExist.Role The role does not exist. 角色不存在。
409 MalformedPolicyDocument The policy format is invalid. 策略格式錯誤。

訪問錯誤中心查看更多錯誤碼。