DescribeARMServerInstances - ENS - Centro de documentación de Alibaba Cloud

Obtiene información sobre servidores ARM e instancias AIC.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ens:DescribeARMServerInstances

list

*Todos los recursos.

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ServerIds	array	No	La lista de ID de instancias de servidor.
	string	No	La lista de ID de instancias de servidor.	cas-instance****
EnsRegionIds	array	No	La lista de ID de zonas de borde de ENS.
	string	No	La lista de ID de zonas de borde de ENS.	cn-chengdu-telecom-4
PageNumber	integer	No	El número de página de la lista de consulta. Valor mínimo: 1. Valor predeterminado: 1.	1
PageSize	integer	No	El número de entradas por página para una consulta paginada. Valor máximo: 100. Valor predeterminado: 10.	10
MinDate	string	No	La fecha de inicio de la consulta. Formato: "2006-01-02". De forma predeterminada, no se aplica ningún límite de tiempo.	2006-01-02
MaxDate	string	No	La fecha de fin de la consulta. Formato: "2006-01-02". De forma predeterminada, no se aplica ningún límite de tiempo.	2006-01-03
States	array	No	La lista de estados de operación.
	string	No	El estado de operación del servidor. Valores válidos: success: correcto. failed: error. creating: en creación. releasing: en liberación. rebooting: en reinicio. upgrading: en actualización.	success
AICSpecs	array	No	La lista de especificaciones de contenedor.
	string	No	La especificación de contenedor.	aic.cf53r.c2.np
ServerSpecs	array	No	La lista de especificaciones de servidor.
	string	No	La especificación de servidor.	cas.cf53r
Name	string	No	El nombre del servidor.	Nombre-del-servidor
Namespace	string	No	El espacio de nombres.	default
Tags	array<object>	No	La lista de etiquetas.
	object	No
Key	string	No	La clave de etiqueta.	key-1
Value	string	No	El valor de etiqueta.	value-1
OrderByParams	string	No	El método de ordenación de los resultados de la consulta. Puede ordenar los resultados por uno o varios de los siguientes campos: ServerIdSort (ID de servidor), ServerNameSort (nombre de servidor), ExpireTimeSort (hora de expiración), CreationTimeSort (hora de creación) y EnsRegionIdSort (ID de zona de borde). Valores válidos: asc (orden ascendente) y desc (orden descendente).	{"ServerIdSort":"desc","ServerNameSort":"desc","ExpireTimeSort":"asc"}
DescribeAICInstances	boolean	No	Especifica si los resultados de la consulta incluyen información de los contenedores. Valores válidos: true: incluida. false: no incluida.	true

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	4EC47282-1B74-4534-BD0E-403F3EE64CAF
Servers	array<object>	La matriz de información de servidores ARM e instancias AIC.
	array<object>
CreationTime	string	La hora en que se creó la instancia.	2022-05-07 11:59:09
ExpiredTime	string	La hora en que expira la instancia.	2027-05-07 11:59:09
AICInstances	array<object>	La matriz de información de las instancias AIC.
	array<object>
Frequency	integer	La frecuencia de actualización de la instancia AIC. Unidad: Hz.	120
ImageId	string	El ID de la imagen AIC.	m-****
InstanceId	string	El ID de la instancia AIC.	aic-instance****
NetworkAttributes	object	Los atributos de red.
IpAddress	string	La dirección IP de la instancia AIC.	192.168.XX.XX
NetworkId	string	El ID de la red de la instancia AIC.	n-*****
VSwitchId	string	El ID del vSwitch de la instancia AIC.	vsw-****
SdgDeployInfo	object	La información de despliegue del grupo de datos compartidos (SDG) en la instancia.
SDGId	string	El ID del SDG.	sdg-xxxxx
Status	string	El estado de despliegue del SDG. Valores válidos: sdg_deploying: En despliegue. failed: Error de despliegue. success: Despliegue correcto.	success
Resolution	string	La resolución de la instancia AIC.	1920*1080
Spec	string	La especificación de la instancia AIC.	aic.cf53r.c2.np
State	string	El estado de operación de la instancia AIC. Valores válidos: success: Correcto. failed: Error. creating: En creación. releasing: En liberación. rebooting: En reinicio. reseting: En restablecimiento.	success
Status	string	El estado de ejecución de la instancia AIC. Valores válidos: running: En ejecución. pending: Pendiente. terminating: En finalización.	running
Name	string	El nombre del contenedor.	AIC-Nombre
LatestAction	string	La operación más reciente.	ServerCreate
EnsRegionId	string	El ID de la zona de borde de ENS.	cn-hanghzou-27
ServerId	string	El ID del servidor.	cas-******
SpecName	string	La especificación de servidor.	cas.cf53r
State	string	El estado de operación del servidor. Valores válidos: success: Correcto. failed: Error. creating: En creación. releasing: En liberación. rebooting: En reinicio. upgrading: En actualización.	success
Status	string	El estado de ejecución del servidor. Valores válidos: running: En ejecución. stopping: En detención. down: Apagado. starting: En inicio.	running
Namespace	string	El espacio de nombres del clúster al que pertenece la tarjeta.	default
Name	string	El nombre del servidor.	Nombre-del-servidor
PayType	string	El método de facturación.	prepay
LatestAction	string	La operación más reciente.	ServerCreate
Tags	array<object>	La colección de etiquetas.
	object	La etiqueta.
Key	string	La clave de etiqueta.	key-1
Value	string	El valor de etiqueta.	value-1
PageNumber	integer	El número de página de la lista de instancias.	1
PageSize	integer	El número de entradas por página que se especificó en la solicitud.	10
TotalCount	integer	El número total de instancias devueltas.	2

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP	Código de error	Mensaje de error
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 error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.