AttachInstanceRamRole - - Centro de documentación de Alibaba Cloud

Llame a esta operación para vincular un rol de RAM de instancia a una o más instancias ECS. Si una instancia ya tiene un rol de RAM de instancia asignado, se devuelve un error al intentar vincularle otro.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	AttachInstanceRamRole	La operación que desea ejecutar. Establezca el valor en AttachInstanceRamRole.
InstanceIds	String	Sí	["i-bp14ss25xca5ex1u", "i-bp154z5o1qjalfse", "i-bp10ws62o04ubhvi"...]	Los ID de las instancias a las que desea vincular el rol de RAM de instancia. Puede ser un array JSON con hasta 100 ID de instancia. Separe varios ID de instancia con comas (,).
RamRoleName	String	Sí	testRamRoleName	El nombre del rol de RAM de instancia. Llame a la operación ListRoles proporcionada por RAM para consultar los roles de RAM que ha creado.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
Policy	String	No	{"Statement": [{"Action": [""],"Effect": "Allow","Resource": [""]}],"Version":"1"}	La política de permisos. Debe tener entre 1 y 1,024 caracteres. Al vincular un rol de RAM a una o más instancias, puede especificar una política adicional para restringir aún más sus permisos. Para obtener más información, consulte Descripción general de políticas.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
AttachInstanceRamRoleResults	Array of AttachInstanceRamRoleResult		Detalles sobre los resultados de la vinculación del rol de RAM de instancia.
AttachInstanceRamRoleResult
Code	String	200	Indica si se vinculó el rol de RAM de instancia. Si se devuelve 200, la vinculación fue exitosa. Cualquier otro valor indica que falló. Para obtener más información, consulte la sección "Códigos de error" de este tema.
InstanceId	String	i-bp10ws62o04ubhvi****	El ID de la instancia.
Message	String	success	Indica si se vinculó el rol de RAM de instancia. Si se devuelve success, la vinculación fue exitosa. Cualquier otro valor indica que falló. Para obtener más información, consulte la sección "Códigos de error" de este tema.
Success	Boolean	true	Indica si se vinculó el rol de RAM.
FailCount	Integer	0	El número de roles de RAM cuya vinculación falló.
RamRoleName	String	testRamRoleName	El nombre del rol de RAM de instancia.
RequestId	String	D9553E4C-6C3A-4D66-AE79-9835AF705639	El ID de la solicitud.
TotalCount	Integer	1	El número total de instancias a las que intentó vincular el rol de RAM de instancia.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=AttachInstanceRamRole
&InstanceIds=["i-bp10ws62o04ubhvi****"]
&RamRoleName=testRamRoleName
&RegionId=cn-hangzhou
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<AttachInstanceRamRoleResponse>
      <RequestId>E6352369-5C2B-41CD-AB50-471550C8F674</RequestId>
      <AttachInstanceRamRoleResults>
            <AttachInstanceRamRoleResult>
                   <InstanceId>i-bp10ws62o04ubhvi****</InstanceId>
                   <Code>200</Code>
                   <Message>success</Message>
            </AttachInstanceRamRoleResult>
      </AttachInstanceRamRoleResults>
      <TotalCount>1</TotalCount>
      <FailCount>0</FailCount>
      <RamRoleName>testRamRoleName</RamRoleName>
</AttachInstanceRamRoleResponse>

Formato JSON

{
    "RequestId": "D9553E4C-6C3A-4D66-AE79-9835AF705639",
    "AttachInstanceRamRoleResults": {
        "AttachInstanceRamRoleResult": [
            {
                "Message": "success",
                "InstanceId": "i-bp10ws62o04ubhvi****",
                "Code": "200"
            }
        ]
    },
    "TotalCount": 1,
    "FailCount": 0,
    "RamRoleName": "testRamRoleName"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidInstanceIds.Malformed	The specified instanceIds are not valid.	Mensaje de error devuelto porque el parámetro InstanceIds especificado no es válido.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist	Mensaje de error devuelto porque la instancia especificada no existe. Compruebe si el ID de la instancia es correcto.
403	InvalidNetworkType.MismatchRamRole	Ram role cannot be applied to instances of Classic network type.	Mensaje de error devuelto porque un rol de RAM de instancia solo se puede usar para instancias en VPC, no para instancias en la red clásica.
403	InvalidUser.PassRoleForbidden	The RAM user does not have the privilege to pass a RAM role.	Mensaje de error devuelto porque el usuario de RAM no tiene autorización para pasar el rol de RAM.
404	InvalidRamRole.NotFound	The specified RAMRoleName does not exist.	Mensaje de error devuelto porque el parámetro RamRoleName especificado no existe.
404	InvalidRamRole.NotEcsRole	The specified ram role is not authorized for ecs, please check your role policy.	Mensaje de error devuelto porque el rol de RAM especificado no tiene autorización para usar ECS. Revise la política de su rol.

Para obtener una lista de códigos de error, visite el Centro de errores de API.