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

Descrição

Ao chamar uma operação de API com o Alibaba Cloud CLI, especifique os valores dos parâmetros de solicitação de diferentes tipos de dados nos formatos exigidos. Para obter mais informações, consulte Visão geral do formato de parâmetros.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeInstanceRamRole	Operação a ser executada. Defina o valor como DescribeInstanceRamRole.
PageNumber	Integer	Não	1	Número da página a retornar. A numeração começa em 1. Valor padrão: 1.
PageSize	Integer	Não	10	Quantidade de entradas por página. Valor máximo: 50. Valor padrão: 10.
RegionId	String	Sim	cn-hangzhou	ID da região da função RAM da instância. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
InstanceIds	String	Não	["i-bp67acfmxazb1p**", "i-bp67acfmxazb2p", "bp67acfmxazb3p**"…]	IDs das instâncias. É possível especificar até 100 IDs em uma única solicitação. Especifique pelo menos um dos parâmetros `InstanceIds` ou `RamRoleName`.
RamRoleName	String	Não	EcsServiceRole-EcsDocGuideTest	Nome da função RAM da instância. Utilize a operação ListRoles do RAM para consultar as funções criadas. Especifique pelo menos um dos parâmetros `InstanceIds` ou `RamRoleName`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
TotalCount	Integer	1	Total de funções RAM de instância retornadas.
RegionId	String	cn-hangzhou	ID da região da função RAM da instância.
InstanceRamRoleSets	Array of InstanceRamRoleSet		Detalhes das funções RAM da instância.
InstanceRamRoleSet
RamRoleName	String	EcsServiceRole-EcsDocGuideTest	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=DescribeInstanceRamRole
&RegionId=cn-hangzhou
&InstanceIds=["i-bp67acfmxazb1p****", "i-bp67acfmxazb2p****", "bp67acfmxazb3p****"]
&PageNumber=1
&PageSize=1
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

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

<DescribeInstanceRamRoleResponse>
    <RequestId>8F4CAE3F-7892-4662-83A5-2C2FFD639553</RequestId>
    <InstanceRamRoleSets>
        <InstanceRamRoleSet>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <RamRoleName>EcsServiceRole-EcsDocGuideTest</RamRoleName>
        </InstanceRamRoleSet>
    </InstanceRamRoleSets>
    <TotalCount>1</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>1</PageSize>
</DescribeInstanceRamRoleResponse>

Formato JSON

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

{
  "RequestId" : "8F4CAE3F-7892-4662-83A5-2C2FFD639553",
  "InstanceRamRoleSets" : {
    "InstanceRamRoleSet" : [ {
      "InstanceId" : "i-bp67acfmxazb4p****",
      "RamRoleName" : "EcsServiceRole-EcsDocGuideTest"
    } ]
  },
  "TotalCount" : 1,
  "PageNumber" : 1,
  "PageSize" : 1
}

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.	O parâmetro InstanceIds especificado é inválido.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.
403	InvalidNetworkType.MismatchRamRole	Ram role cannot be applied to instances of Classic network type.	Funções RAM de instância aplicam-se apenas a instâncias em Virtual Private Clouds (VPCs), não à rede clássica.
403	InvalidParameter.AllEmpty	%s	Parâmetros obrigatórios não especificados.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist	A instância especificada não existe. Verifique se o ID da instância está correto.

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