AttachInstanceRamRole - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AttachInstanceRamRole	A operação que você deseja executar. Defina o valor como AttachInstanceRamRole.
InstanceIds	String	Sim	["i-bp14ss25xca5ex1u", "i-bp154z5o1qjalfse", "i-bp10ws62o04ubhvi"...]	Os IDs das instâncias às quais você deseja vincular a função RAM de instância. Pode ser um array JSON composto por até 100 IDs de instância. Separe múltiplos IDs de instância com vírgulas (,).
RamRoleName	String	Sim	testRamRoleName	O nome da função RAM de instância. Chame a operação ListRoles fornecida pelo RAM para consultar as funções RAM criadas por você.
RegionId	String	Sim	cn-hangzhou	O ID da região da instância. Chame a operação DescribeRegions para obter a lista de regiões mais recente.
Policy	String	Não	{"Statement": [{"Action": [""],"Effect": "Allow","Resource": [""]}],"Version":"1"}	A política de permissões. A política deve ter entre 1 e 1.024 caracteres. Ao vincular uma função RAM a uma ou mais instâncias, especifique uma política adicional para restringir ainda mais as permissões da função RAM. Para mais informações, consulte Visão geral de políticas.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
AttachInstanceRamRoleResults	Array of AttachInstanceRamRoleResult		Detalhes sobre os resultados da vinculação da função RAM de instância.
AttachInstanceRamRoleResult
Code	String	200	Indica se a função RAM de instância foi vinculada. Se 200 for retornado, a função RAM foi vinculada com sucesso. Qualquer outro valor indica falha na vinculação. Para mais detalhes, consulte a seção "Códigos de erro" deste tópico.
InstanceId	String	i-bp10ws62o04ubhvi****	O ID da instância.
Message	String	success	Indica o status da vinculação da função RAM de instância. O retorno "success" confirma que a função RAM foi vinculada. Outros valores sinalizam falha na operação. Consulte a seção "Códigos de erro" deste tópico para mais informações.
Success	Boolean	true	Indica se a função RAM foi vinculada.
FailCount	Integer	0	O número de funções RAM cuja vinculação falhou.
RamRoleName	String	testRamRoleName	O nome da função RAM de instância.
RequestId	String	D9553E4C-6C3A-4D66-AE79-9835AF705639	O ID da solicitação.
TotalCount	Integer	1	O número total de instâncias nas quais se tentou vincular a função RAM de instância.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstanceIds.Malformed	The specified instanceIds are not valid.	Mensagem retornada porque o parâmetro InstanceIds especificado é inválido.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist	Mensagem retornada porque a instância especificada não existe. Verifique se o ID da instância está correto.
403	InvalidNetworkType.MismatchRamRole	Ram role cannot be applied to instances of Classic network type.	Mensagem retornada porque uma função RAM de instância só pode ser usada em instâncias em VPCs, e não em instâncias na rede clássica.
403	InvalidUser.PassRoleForbidden	The RAM user does not have the privilege to pass a RAM role.	Mensagem retornada porque o usuário RAM não tem autorização para passar a função RAM.
404	InvalidRamRole.NotFound	The specified RAMRoleName does not exist.	Mensagem retornada porque o parâmetro RamRoleName especificado não existe.
404	InvalidRamRole.NotEcsRole	The specified ram role is not authorized for ecs, please check your role policy.	Mensagem retornada porque a função RAM especificada não tem autorização para usar o ECS. Verifique a política da função.

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.