调用 AssociateInstancesIamRole 接口为一台或多台实例绑定IAM角色。

请求说明

• 执行该操作前，您需要为IAM角色授予云服务器ECS相关策略，授权操作请参见角色管理。
• 调用该接口时，一台实例仅允许用户绑定一个IAM角色（不包含服务关联的角色）。

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例

GET /?Action=AssociateInstancesIamRole&Version=2020-04-01&InstanceIds.1=i-3tiefmkskq3vj0******&IamRoleName=EcsTestRole HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: ecs

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021110417394001022514606307D7****",
        "Action": "AssociateInstancesIamRole",
        "Version": "2020-04-01",
        "Service": "ecs",
        "Region": "cn-beijing"
    },
    "Result": {
        "OperationDetails": [
            {
                "InstanceId": "i-ahipakt2gcg95jpv****",
                "Error": null
            },
            {
                "InstanceId": "i-ahipakt2hgg95k5c****",
                "Error": {
                    "Code": "InvalidInstance.NotFound",
                    "Message": "The specified instance does not exist."
                }
            }
        ]
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。