調用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::123456789012****:root" } } ], "Version": "1" }

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

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

RAM角色描述。
MaxSessionDuration Long 3600

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

RAM角色ID。
RoleName String ECSAdmin

RAM角色名稱。
UpdateDate String 2015-01-23T12:33:18Z

RAM角色的更新時間。

樣本

請求樣本

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

正常返回樣本

XML格式 

<UpdateRoleResponse>
	  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
	  <Role>
		    <RoleId>901234567890****</RoleId>
		    <RoleName>ECSAdmin</RoleName>
		    <Arn>acs:ram::123456789012****:role/ECSAdmin</Arn>
		    <Description>ECS管理角色</Description>
		    <MaxSessionDuration>3600</MaxSessionDuration>
		    <AssumeRolePolicyDocument>{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "RAM": "acs:ram::123456789012****: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": "901234567890****",
        "RoleName": "ECSAdmin",
        "Arn": "acs:ram::123456789012****:role/ECSAdmin",
        "Description": "ECS管理角色",
        "MaxSessionDuration": 3600,
        "AssumeRolePolicyDocument": "{ \"Statement\": [ { \"Action\": \"sts:AssumeRole\", \"Effect\": \"Allow\", \"Principal\": { \"RAM\": \"acs:ram::123456789012****:root\" } } ], \"Version\": \"1\" }",
        "CreateDate": "2015-01-23T12:33:18Z",
        "UpdateDate": "2015-01-23T12:33:18Z"
    }
}

錯誤碼

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