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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DetachInstanceRamRole	Operação a executar. Defina o valor como DetachInstanceRamRole.
RegionId	String	Sim	cn-hangzhou	ID da região. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
RamRoleName	String	Não	RamRoleTest	Nome da função RAM da instância. Use a operação ListRoles do RAM para listar as funções RAM de instância criadas.
InstanceIds	String	Sim	["i-bp67acfmxazb4p", "i-bp67acfmxazb5p", "i-bp67acfmxazb6p"…]	IDs das instâncias. O valor pode ser um array JSON com até 100 IDs de instância. Separe os IDs por vírgulas (,).

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RamRoleName	String	RamRoleTest	Nome da função RAM da instância.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
TotalCount	Integer	1	Número total de instâncias das quais houve tentativa de desassociar funções RAM.
FailCount	Integer	0	Quantidade de instâncias em que falhou a desassociação da função RAM.
DetachInstanceRamRoleResults	Array of DetachInstanceRamRoleResult		Resultados da desassociação da função RAM das instâncias.
DetachInstanceRamRoleResult
Code	String	200	Indica se a função RAM foi desassociada da instância. O código de status 200 significa sucesso na solicitação. Outros códigos indicam falha.
Message	String	Success	Informa o resultado da desassociação da função RAM. O status Success confirma o êxito da operação. Demais valores apontam falhas. Para mais informações, consulte a seção "Códigos de erro" neste tópico.
InstanceId	String	i-bp67acfmxazb4p****	ID da instância da qual houve tentativa de desassociar a função RAM.
Success	Boolean	true	Indica se a função RAM da instância foi desassociada com sucesso.
InstanceRamRoleSets	Array of InstanceRamRoleSet		Funções RAM associadas às instâncias.
InstanceRamRoleSet
RamRoleName	String	RamRoleTest	Nome da função RAM da instância.
InstanceId	String	i-bp67acfmxazb4p****	ID da instância.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DetachInstanceRamRole
&InstanceIds=["i-bp67acfmxazb4p****", "i-bp67acfmxazb5p****", "i-bp67acfmxazb6p****"…]
&RegionId=cn-hangzhou
&RamRoleName=RamRoleTest
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DetachInstanceRamRoleResponse>
    <TotalCount>1</TotalCount>
    <DetachInstanceRamRoleResults>
        <DetachInstanceRamRoleResult>
            <Message>success</Message>
            <InstanceId>i-bp16qng6jnvt6g7t****</InstanceId>
            <Code>200</Code>
            <InstanceRamRoleSets>
                <InstanceId>i-bp16qng6jnvt6g7t****</InstanceId>
                <RamRoleName>RamRoleTest</RamRoleName>
            </InstanceRamRoleSets>
        </DetachInstanceRamRoleResult>
    </DetachInstanceRamRoleResults>
    <RequestId>14D5B163-CE6C-4489-B979-DBE5D0495A63</RequestId>
    <RamRoleName/>
    <FailCount>0</FailCount>
</DetachInstanceRamRoleResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "DetachInstanceRamRoleResults" : {
    "DetachInstanceRamRoleResult" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp16qng6jnvt6g7t****",
      "Code" : "200",
      "InstanceRamRoleSets" : {
        "InstanceId" : "i-bp16qng6jnvt6g7t****",
        "RamRoleName" : "RamRoleTest"
      }
    } ]
  },
  "RequestId" : "14D5B163-CE6C-4489-B979-DBE5D0495A63",
  "RamRoleName" : "",
  "FailCount" : 0
}

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.	Os IDs de instância especificados são inválidos.
403	InvalidNetworkType.MismatchRamRole	Ram role cannot be applied to instances of Classic network type.	Funções RAM de instância são compatíveis apenas com instâncias em Virtual Private Clouds (VPCs), não sendo aplicáveis à rede clássica.
403	InvalidUser.PassRoleForbidden	The RAM user does not have the privilege to pass a RAM role.	O usuário RAM não tem permissão para transmitir uma função RAM.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.	O ID da instância especificado não foi encontrado.

Para obter uma lista completa dos códigos de erro, consulte Códigos de erro do serviço.