DescribeARMServerInstances - ENS: Central de Documentação do Alibaba Cloud

Obtém informações sobre servidores ARM e instâncias AIC.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ens:DescribeARMServerInstances

list

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ServerIds	array	Não	A lista de IDs de instâncias de servidor.
	string	Não	A lista de IDs de instâncias de servidor.	cas-instance****
EnsRegionIds	array	Não	A lista de IDs de zonas de borda ENS.
	string	Não	A lista de IDs de zonas de borda ENS.	cn-chengdu-telecom-4
PageNumber	integer	Não	O número da página da lista de consulta. Valor mínimo: 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página para uma consulta paginada. Valor máximo: 100. Valor padrão: 10.	10
MinDate	string	Não	A hora de início da consulta. Formato: "2006-01-02". Por padrão, nenhum limite de tempo é aplicado.	2006-01-02
MaxDate	string	Não	A hora de término da consulta. Formato: "2006-01-02". Por padrão, nenhum limite de tempo é aplicado.	2006-01-03
States	array	Não	A lista de estados de operação.
	string	Não	O estado de operação do servidor. Valores válidos: success: Bem-sucedido. failed: Falhou. creating: Sendo criado. releasing: Sendo liberado. rebooting: Sendo reiniciado. upgrading: Sendo atualizado.	success
AICSpecs	array	Não	A lista de especificações de contêiner.
	string	Não	A especificação do contêiner.	aic.cf53r.c2.np
ServerSpecs	array	Não	A lista de especificações de servidor.
	string	Não	A especificação do servidor.	cas.cf53r
Name	string	Não	O nome do servidor.	Nome-do-Servidor
Namespace	string	Não	O namespace.	default
Tags	array<object>	Não	A lista de tags.
	object	Não
Key	string	Não	A chave da tag.	key-1
Value	string	Não	O valor da tag.	value-1
OrderByParams	string	Não	O método de classificação para os resultados da consulta. Você pode classificar os resultados por um ou mais dos seguintes campos: ServerIdSort (ID do servidor), ServerNameSort (nome do servidor), ExpireTimeSort (hora de expiração), CreationTimeSort (hora de criação) e EnsRegionIdSort (ID da zona de borda). Valores válidos: asc (ordem crescente) e desc (ordem decrescente).	{"ServerIdSort":"desc","ServerNameSort":"desc","ExpireTimeSort":"asc"}
DescribeAICInstances	boolean	Não	Especifica se os resultados da consulta incluem informações do contêiner. Valores válidos: true: Incluído. false: Não incluído.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	4EC47282-1B74-4534-BD0E-403F3EE64CAF
Servers	array<object>	A matriz de informações de servidores ARM e instâncias AIC.
	array<object>
CreationTime	string	A hora em que a instância foi criada.	2022-05-07 11:59:09
ExpiredTime	string	A hora em que a instância expira.	2027-05-07 11:59:09
AICInstances	array<object>	A matriz de informações de instâncias AIC.
	array<object>
Frequency	integer	A taxa de atualização da instância AIC. Unidade: Hz.	120
ImageId	string	O ID da imagem AIC.	m-****
InstanceId	string	O ID da instância AIC.	aic-instance****
NetworkAttributes	object	Os atributos de rede.
IpAddress	string	O endereço IP da instância AIC.	192.168.XX.XX
NetworkId	string	O ID de rede da instância AIC.	n-*****
VSwitchId	string	O ID do vSwitch da instância AIC.	vsw-****
SdgDeployInfo	object	As informações do grupo de dados compartilhados (SDG) implantado na instância.
SDGId	string	O ID do SDG.	sdg-xxxxx
Status	string	O status de implantação do SDG. Valores válidos: sdg_deploying: Sendo implantado. failed: Falha na implantação. success: Implantação bem-sucedida.	success
Resolution	string	A resolução da instância AIC.	1920*1080
Spec	string	A especificação da instância AIC.	aic.cf53r.c2.np
State	string	O estado de operação da instância AIC. Valores válidos: success: Bem-sucedido. failed: Falhou. creating: Sendo criado. releasing: Sendo liberado. rebooting: Sendo reiniciado. reseting: Sendo redefinido.	success
Status	string	O status de execução da instância AIC. Valores válidos: running: Em execução. pending: Pendente. terminating: Sendo encerrado.	running
Name	string	O nome do contêiner.	AIC-Name
LatestAction	string	A operação mais recente.	ServerCreate
EnsRegionId	string	O ID da zona de borda ENS.	cn-hanghzou-27
ServerId	string	O ID do servidor.	cas-******
SpecName	string	A especificação do servidor.	cas.cf53r
State	string	O estado de operação do servidor. Valores válidos: success: Bem-sucedido. failed: Falhou. creating: Sendo criado. releasing: Sendo liberado. rebooting: Sendo reiniciado. upgrading: Sendo atualizado.	success
Status	string	O status de execução do servidor. Valores válidos: running: Em execução. stopping: Sendo parado. down: Desligado. starting: Sendo iniciado.	running
Namespace	string	O namespace do cluster ao qual a placa pertence.	default
Name	string	O nome do servidor.	Nome-do-Servidor
PayType	string	O método de cobrança.	prepay
LatestAction	string	A operação mais recente.	ServerCreate
Tags	array<object>	A coleção de tags.
	object	A tag.
Key	string	A chave da tag.	key-1
Value	string	O valor da tag.	value-1
PageNumber	integer	O número da página da lista de instâncias.	1
PageSize	integer	O número de entradas por página que foi especificado na solicitação.	10
TotalCount	integer	O número total de instâncias retornadas.	2

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "Servers": [
    {
      "CreationTime": "2022-05-07 11:59:09",
      "ExpiredTime": "2027-05-07 11:59:09",
      "AICInstances": [
        {
          "Frequency": 120,
          "ImageId": "m-****",
          "InstanceId": "aic-instance****",
          "NetworkAttributes": {
            "IpAddress": "192.168.XX.XX",
            "NetworkId": "n-*****",
            "VSwitchId": "vsw-****"
          },
          "SdgDeployInfo": {
            "SDGId": "sdg-xxxxx",
            "Status": "success"
          },
          "Resolution": "1920*1080",
          "Spec": "aic.cf53r.c2.np",
          "State": "success",
          "Status": "running",
          "Name": "AIC-Name",
          "LatestAction": "ServerCreate"
        }
      ],
      "EnsRegionId": "cn-hanghzou-27",
      "ServerId": "cas-******",
      "SpecName": "cas.cf53r",
      "State": "success",
      "Status": "running",
      "Namespace": "default",
      "Name": "Server-Name",
      "PayType": "prepay",
      "LatestAction": "ServerCreate",
      "Tags": [
        {
          "Key": "key-1",
          "Value": "value-1"
        }
      ]
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 2
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	Parameter.Invalid	This service has not been activated.
400	Interface.Call.Error	The interface call error
400	Interface.Call.Failed	%s.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.