DescribeCloudAssistantStatus - - Centro de documentación de Alibaba Cloud

Consulta si Cloud Assistant Agent está instalado en una o más instancias. Si Cloud Assistant Agent está instalado, el sistema obtiene el número total de comandos de Cloud Assistant ejecutados, la cantidad de comandos en ejecución y la hora de la última ejecución.

Notas de uso

Antes de ejecutar comandos o enviar archivos a las instancias, especialmente si son nuevas, se recomienda consultar el estado de Cloud Assistant mediante esta operación y verificar el valor devuelto por CloudAssistantStatus. Ejecute los comandos o envíe archivos a las instancias únicamente cuando el valor devuelto sea true.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda invocar esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeCloudAssistantStatus	La operación que desea realizar. Establezca el valor en DescribeCloudAssistantStatus.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.
OSType	String	No	Windows	El tipo de sistema operativo de la instancia. Valores válidos: Windows Linux FreeBSD
PageNumber	Long	No	1	El número de página. Las páginas comienzan desde la página 1. Valor predeterminado: 1.
PageSize	Long	No	10	El número de entradas por página. Si especifica InstanceId, este parámetro no surte efecto. Valores válidos: 1 a 50. Valor predeterminado: 10.
InstanceId.N	String	No	i-bp1iudwa5b1tqa****	El ID de la instancia N. La instancia puede ser una instancia de Elastic Compute Service (ECS) o una instancia administrada. Puede especificar hasta 100 IDs de instancia en una sola solicitud.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
PageSize	Long	1	El número de entradas por página.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.
PageNumber	Long	1	El número de página.
TotalCount	Long	1	El número total de instancias.
InstanceCloudAssistantStatusSet	Array of InstanceCloudAssistantStatus		Detalles sobre el estado de instalación de Cloud Assistant Agent en las instancias.
InstanceCloudAssistantStatus
CloudAssistantStatus	String	true	Indica si Cloud Assistant se está ejecutando en la instancia. Valores válidos: true: Se detectaron latidos en un periodo de 2 minutos. false: No se detectaron latidos en un periodo de 2 minutos.
LastInvokedTime	String	2021-03-15T08:00:00Z	La hora de la última ejecución de comandos.
CloudAssistantVersion	String	2.2.0.106	El número de versión de Cloud Assistant Agent. Este parámetro aparece vacío si Cloud Assistant Agent no está instalado o no se está ejecutando en la instancia.
ActiveTaskCount	Long	0	El número de tareas que Cloud Assistant estaba ejecutando en la instancia.
InvocationCount	Long	2	El número de tareas completadas por Cloud Assistant en la instancia.
InstanceId	String	i-bp1iudwa5b1tqa****	El ID de la instancia.
LastHeartbeatTime	String	2021-03-15T09:00:00Z	La hora del último latido de Cloud Assistant. El valor se actualiza cada minuto en promedio. El intervalo puede ser de 55, 60 o 65 segundos.
OSType	String	Linux	El tipo de sistema operativo de la instancia. Valores válidos: Windows Linux FreeBSD
SupportSessionManager	Boolean	true	Indica si Cloud Assistant admite Session Manager en la instancia. Si Session Manager no es compatible, significa que la versión de Cloud Assistant es obsoleta. Actualice Cloud Assistant Agent a la versión más reciente. Para admitir Session Manager, la versión de Cloud Assistant debe ser igual o posterior a las siguientes: Linux: 2.2.3.189 Windows: 2.1.3.189

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=DescribeCloudAssistantStatus
&InstanceId.1=i-bp1iudwa5b1tqa****
&RegionId=cn-hangzhou
&<Common request parameters>

Respuesta exitosa de ejemplo

Formato XML

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

<DescribeCloudAssistantStatusResponse>
    <TotalCount>1</TotalCount>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageSize>1</PageSize>
    <PageNumber>1</PageNumber>
    <InstanceCloudAssistantStatusSet>
        <InstanceCloudAssistantStatus>
            <CloudAssistantVersion>2.2.0.106</CloudAssistantVersion>
            <SupportSessionManager>true</SupportSessionManager>
            <InstanceId>i-bp1iudwa5b1tqa****</InstanceId>
            <CloudAssistantStatus>true</CloudAssistantStatus>
            <OSType>Linux</OSType>
            <InvocationCount>2</InvocationCount>
            <ActiveTaskCount>0</ActiveTaskCount>
            <LastInvokedTime>2021-03-15T08:00:00Z</LastInvokedTime>
            <LastHeartbeatTime>2021-03-15T09:00:00Z</LastHeartbeatTime>
        </InstanceCloudAssistantStatus>
    </InstanceCloudAssistantStatusSet>
</DescribeCloudAssistantStatusResponse>

Formato JSON

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

{
  "TotalCount" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageSize" : 1,
  "PageNumber" : 1,
  "InstanceCloudAssistantStatusSet" : {
    "InstanceCloudAssistantStatus" : [ {
      "CloudAssistantVersion" : "2.2.0.106",
      "SupportSessionManager" : true,
      "InstanceId" : "i-bp1iudwa5b1tqa****",
      "CloudAssistantStatus" : "true",
      "OSType" : "Linux",
      "InvocationCount" : 2,
      "ActiveTaskCount" : 0,
      "LastInvokedTime" : "2021-03-15T08:00:00Z",
      "LastHeartbeatTime" : "2021-03-15T09:00:00Z"
    } ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	RegionId.ApiNotSupported	The api is not supported in this region.	Esta operación no se puede realizar en la región especificada. Compruebe si el ID de región es válido.
400	MissingParam.InstanceId	The parameter instanceId is missing or empty.	Deben especificarse los IDs de instancia.
400	InvalidParam.PageSize	The specified parameter is invalid.	Valor de PageSize no válido.
400	InvalidParam.PageNumber	The specified parameter is invalid.	Valor de PageNumber no válido.
403	InstanceIds.ExceedLimit	The number of instance IDs exceeds the upper limit.	Se superó el número máximo de IDs de instancia.
403	Operation.Forbidden	The operation is not permitted.	La operación no es compatible.
404	InvalidInstance.NotFound	The specified instance does not exist.	No se encontró la instancia especificada.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Ocurrió un error al enviar la solicitud. Inténtelo de nuevo más tarde.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	La solicitud falló debido a un error temporal del servidor backend.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.