全部产品
云服务器 ECS

AttachInstanceRamRole

更新时间:2017-09-13 09:27:22   分享:   

描述

附加实例 RAM 角色到实例上,实时生效。如果实例已有 RAM 角色,则报错提示用户不能附加新的角色。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:AttachInstanceRamRole。
RegionId String 地域 ID。Region ID 的列表详见 地域列表
InstanceIds Array 实例 ID 集,最多 100 个实例,[“instanceId1”, “instanceId2”, “instanceId3”…]。
RamRoleName String 实例 RAM 角色名称,名称由 RAM 提供和维护,使用 RAM 的 ListRoles 接口查询。

返回参数

全是公共返回参数,详见 公共参数

错误码

错误代码 描述 HTTP 状态码 语义
InvalidInstanceIds.Malformed The specified InstanceIds is not valid. 400 指定的 InstanceIds 不合法。
MissingParameter.InstanceIds The input parameter InstanceIds that is mandatory for processing this request is missing. 400 缺少必填参数 InstanceIds。
MissingParameter.RamRoleName The input parameter RamRoleName that is mandatory for processing this request is missing. 400 缺少必填参数 RamRoleName。
MissingParameter.RegionId The input parameter RegionId that is mandatory for processing this request is missing. 400 缺少必填参数 RegionId。
InvalidNetworkType.MismatchRamRole Ram role cannot be attached to instances of Classic network type. 403 实例 RAM 角色不能被用于经典网络。
InvalidUser.PassRoleForbidden The RAM user does not have the privilege to pass a role. 403 RAM 用户不具有 PassRole 的权限。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的实例 ID 不存在。
InvalidRamRole.NotFound The specified RamRoleName does not exist. 404 指定的 RamRoleName 不存在。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=AttachInstanceRamRole
  2. &RegionId=cn-hangzhou
  3. &RamRoleName=RamRoleTest
  4. &InstanceIds=["i-instance1"]
  5. &<公共请求参数>

返回示例

XML 示例

  1. <AttachInstanceRamRoleResponse>
  2. <RequestId>E6352369-5C2B-41CD-AB50-471550C8F674</RequestId>
  3. <AttachInstanceRamRoleResults>
  4. <AttachInstanceRamRoleResult>
  5. <InstanceId>i-instance1</InstanceId>
  6. <Code>200</Code>
  7. <Message>success</Message>
  8. </AttachInstanceRamRoleResult>
  9. </AttachInstanceRamRoleResults>
  10. <TotalCount>1</TotalCount>
  11. <FailCount>0</FailCount>
  12. <RamRoleName>RamRoleTest</RamRoleName>
  13. </AttachInstanceRamRoleResponse>

JSON 示例

  1. {
  2. "RequestId": "D9553E4C-6C3A-4D66-AE79-9835AF705639",
  3. "AttachInstanceRamRoleResults": {
  4. "AttachInstanceRamRoleResult": [
  5. {
  6. "Message": "success",
  7. "InstanceId": "i-instance1",
  8. "Code": "200"
  9. }
  10. ]
  11. },
  12. "TotalCount": 1,
  13. "FailCount": 0,
  14. "RamRoleName": "RamRoleTest"
  15. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?