GetInstanceInspections - - Centro de documentación de Alibaba Cloud

Consulte el resultado de una inspección que se ejecuta en una instancia de base de datos mediante la función de inspección y puntuación.

Database Autonomy Service (DAS) proporciona la función de inspección y puntuación. Esta función le permite inspeccionar y calificar periódicamente el estado de salud de sus instancias, lo cual facilita obtener información sobre el estado de sus bases de datos. Para más información, consulte Inspección y puntuación.

Antes de llamar a esta operación, compruebe que se cumplen los requisitos a continuación:

Esta operación solo es compatible con bases de datos ApsaraDB RDS for MySQL, bases de datos MySQL autogestionadas en instancias de Elastic Compute Service (ECS), bases de datos MySQL autogestionadas en su centro de datos, bases de datos ApsaraDB for Redis y bases de datos PolarDB for MySQL.
Si utiliza un SDK de Alibaba Cloud, compruebe que la versión de aliyun-sdk-core sea posterior a la 4.3.3. Se recomienda usar la versión más reciente.
La versión del SDK de DAS debe ser la 1.0.3 o posterior.
Si llama a DAS mediante un SDK, establezca la región en cn-shanghai.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	GetInstanceInspections	Operación que se va a ejecutar. Establezca el valor en GetInstanceInspections.
Engine	String	Sí	MySQL	Motor de la base de datos. Valores válidos: MySQL Redis PolarDBMySQL
StartTime	String	Sí	1655416825000	Hora de inicio de la tarea de inspección y puntuación. Especifique la hora en formato de marca de tiempo UNIX. Unidad: milisegundos.
EndTime	String	Sí	1655427625000	Hora de finalización de la tarea de inspección y puntuación. Especifique la hora en formato de marca de tiempo UNIX. Unidad: milisegundos. Nota La hora de finalización debe ser posterior a la hora de inicio.
PageNo	String	Sí	1	Número de la página que se va a devolver. La numeración comienza en 1. Valor predeterminado: 1.
PageSize	String	Sí	10	Número máximo de entradas que se devuelven en cada página. Valor predeterminado: 10.
InstanceArea	String	Sí	RDS	Tipo de instancia donde se despliega la base de datos. Valores válidos: RDS: instancia de base de datos de Alibaba Cloud. ECS: instancia de ECS donde se despliega una base de datos autogestionada. IDC: instancia de base de datos autogestionada que no está desplegada en Alibaba Cloud. Nota El valor IDC indica que la instancia está desplegada en un centro de datos.
SearchMap	String	No	{"InstanceId":"rm-bp10usoc1erj7****"}	Condición de filtro. Se puede especificar en uno de los formatos a continuación: Especifique el ID de una sola instancia con el formato {"InstanceId":"Instance ID"}. Especifique los ID de varias instancias con el formato {"InstanceIds":["Instance ID1","Instance ID2"]}. Separe los ID de instancia con comas (,). Especifique la región donde se ubica la instancia con el formato {"region":"Region of the instance"}.
ResourceGroupId	String	No	rg-aek2eil6npi****	ID del resource group.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Message	String	Successful	Mensaje que devuelve la solicitud. Nota Si la solicitud se completa correctamente, se devuelve Successful. Si falla, se devuelve un mensaje de error que contiene información como el código de error.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	ID de la solicitud.
Data	Object		Detalles del resultado de inspección y puntuación.
List	Array of BaseInspection		Detalles de los resultados de inspección y puntuación.
EndTime	Long	1608888296001	Hora de finalización de la tarea de inspección y puntuación. Corresponde a una marca de tiempo UNIX. Unidad: milisegundos. Nota La hora de finalización debe ser posterior a la hora de inicio.
StartTime	Long	1608888296000	Hora de inicio de la tarea de inspección y puntuación. Corresponde a una marca de tiempo UNIX. Unidad: milisegundos.
Data	Map		Datos devueltos.
Instance	Object		Detalles de la instancia.
VpcId	String	vpc-bp1knt7m55z9exoo7****	ID de la red privada virtual (VPC) donde se despliega la instancia.
Uuid	String	hdm_3063db6792965c080a4bcb6e6304****	Identificador único de la instancia.
InstanceArea	String	RDS	Tipo de instancia donde se despliega la base de datos. Valores válidos: RDS: instancia de base de datos de Alibaba Cloud. ECS: instancia de ECS donde se despliega una base de datos autogestionada. IDC: instancia de base de datos autogestionada que no está desplegada en Alibaba Cloud. Nota El valor IDC indica que la instancia está desplegada en un centro de datos.
InstanceClass	String	rds.mysql.s2.xlarge	Tipo de la instancia.
Region	String	cn-hangzhou	ID de la región de la instancia.
AccountId	String	108398049688****	ID de la cuenta. Obtenga el ID de la cuenta con la que inició sesión en la página Security Settings del account management center de Alibaba Cloud.
NetworkType	String	VPC	Tipo de red de la instancia.
Engine	String	MySQL	Motor de la base de datos. Valores válidos: MySQL Redis PolarDBMySQL
InstanceId	String	rm-bp10usoc1erj7****	ID de la instancia.
NodeId	String	rm-bp10usoc1erj7****	ID del nodo de la instancia.
EngineVersion	String	8.0	Número de versión del motor de la base de datos.
InstanceAlias	String	test-01	Nombre de la instancia.
Cpu	String	8	Especificación de CPU de la instancia. Por ejemplo, si se devuelve el valor 8, la instancia tiene 8 núcleos de CPU.
Memory	Integer	32768	Capacidad de memoria de la base de datos desplegada en la instancia. Unidad: MB.
Storage	Integer	150	Espacio de almacenamiento de la instancia. Unidad: GB.
Category	String	standard	Modo de conexión de la instancia. Valores válidos: standard: modo estándar. safe: modo de proxy de base de datos.
ScoreMap	Map		Detalles de la puntuación deducida de la instancia.
GmtCreate	Long	1603247192000	Hora en que se creó la tarea. Corresponde a una marca de tiempo UNIX. Unidad: milisegundos.
Score	Integer	100	Puntuación de inspección de la instancia.
AutoFunction	Object		Indica si el servicio de autonomía está habilitado.
EventSubscription	Integer	0	Indica si la función de suscripción a eventos está habilitada. Valores válidos: 0: deshabilitada. 1: habilitada. 2: no compatible.
AutoIndex	Integer	2	Indica si la función de creación y eliminación automática de índices está habilitada. Valores válidos: 0: deshabilitada. 1: habilitada. 2: no compatible.
AutoLimitedSql	Integer	2	Indica si la función de limitación automática está habilitada. Valores válidos: 0: deshabilitada. 1: habilitada. 2: no compatible.
AutoResourceOptimize	Integer	0	Indica si la recuperación automática de fragmentos está habilitada. Valores válidos: 0: deshabilitada. 1: habilitada. 2: no compatible.
AutoScale	Integer	0	Indica si la función de escalado automático está habilitada. Valores válidos: 0: deshabilitada. 1: habilitada. 2: no compatible.
EnableDasPro	Integer	0	Indica si DAS Professional Edition está habilitado. Valores válidos: 0: deshabilitado. 1: habilitado. 2: no compatible.
State	Integer	2	Estado de la tarea de inspección y puntuación. Valores válidos: 0: la tarea está en espera de ejecución. 1: la tarea está en curso. 2: la tarea finalizó.
TaskType	Integer	0	Modo en que se inicia la tarea de inspección y puntuación. Valores válidos: 0: modo automático. 1: modo manual.
PageNo	Long	1	Número de la página devuelta. La numeración comienza en 1. Valor predeterminado: 1.
PageSize	Long	10	Número máximo de entradas devueltas por página. Valor predeterminado: 10.
Total	Long	4	Número total de entradas devueltas.
Code	String	200	Código de estado HTTP devuelto.
Success	String	true	Indica si la solicitud se completó correctamente. Valores válidos: true: la solicitud se completó correctamente. false: la solicitud terminó con errores.

Ejemplos

Solicitudes de ejemplo

http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetInstanceInspections
&Engine=MySQL
&StartTime=1655416825000
&EndTime=1655427625000
&PageNo=1
&PageSize=10
&InstanceArea=RDS
&SearchMap={"InstanceId":"rm-bp10usoc1erj7****"}
&ResourceGroupId=rg-aek2eil6npi****
&<Common request parameters>

Respuestas de ejemplo exitosas

Formato XML

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

<GetInstanceInspectionsResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <List>
            <EndTime>1608888296001</EndTime>
            <StartTime>1608888296000</StartTime>
            <Instance>
                <VpcId>vpc-bp1knt7m55z9exoo7****</VpcId>
                <Uuid>hdm_3063db6792965c080a4bcb6e6304****</Uuid>
                <InstanceArea>RDS</InstanceArea>
                <InstanceClass>rds.mysql.s2.xlarge</InstanceClass>
                <Region>cn-hangzhou</Region>
                <AccountId>108398049688****</AccountId>
                <NetworkType>VPC</NetworkType>
                <Engine>MySQL</Engine>
                <InstanceId>rm-bp10usoc1erj7****</InstanceId>
                <NodeId>rm-bp10usoc1erj7****</NodeId>
                <EngineVersion>8.0</EngineVersion>
                <InstanceAlias>test-01</InstanceAlias>
                <Cpu>8</Cpu>
                <Memory>32768</Memory>
                <Storage>150</Storage>
                <Category>standard</Category>
            </Instance>
            <GmtCreate>1603247192000</GmtCreate>
            <Score>100</Score>
            <AutoFunction>
                <EventSubscription>0</EventSubscription>
                <AutoIndex>2</AutoIndex>
                <AutoLimitedSql>2</AutoLimitedSql>
                <AutoResourceOptimize>0</AutoResourceOptimize>
                <AutoScale>0</AutoScale>
            </AutoFunction>
            <EnableDasPro>0</EnableDasPro>
            <State>2</State>
            <TaskType>0</TaskType>
        </List>
        <PageNo>1</PageNo>
        <PageSize>10</PageSize>
        <Total>4</Total>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</GetInstanceInspectionsResponse>

Formato JSON

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : {
    "List" : [ {
      "EndTime" : 1608888296001,
      "StartTime" : 1608888296000,
      "Instance" : {
        "VpcId" : "vpc-bp1knt7m55z9exoo7****",
        "Uuid" : "hdm_3063db6792965c080a4bcb6e6304****",
        "InstanceArea" : "RDS",
        "InstanceClass" : "rds.mysql.s2.xlarge",
        "Region" : "cn-hangzhou",
        "AccountId" : "108398049688****",
        "NetworkType" : "VPC",
        "Engine" : "MySQL",
        "InstanceId" : "rm-bp10usoc1erj7****",
        "NodeId" : "rm-bp10usoc1erj7****",
        "EngineVersion" : "8.0",
        "InstanceAlias" : "test-01",
        "Cpu" : "8",
        "Memory" : 32768,
        "Storage" : 150,
        "Category" : "standard"
      },
      "GmtCreate" : 1603247192000,
      "Score" : 100,
      "AutoFunction" : {
        "EventSubscription" : 0,
        "AutoIndex" : 2,
        "AutoLimitedSql" : 2,
        "AutoResourceOptimize" : 0,
        "AutoScale" : 0
      },
      "EnableDasPro" : 0,
      "State" : 2,
      "TaskType" : 0
    } ],
    "PageNo" : 1,
    "PageSize" : 10,
    "Total" : 4
  },
  "Code" : "200",
  "Success" : "true"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParams	The request parameters are invalid.	Mensaje de error devuelto porque los parámetros de solicitud especificados no son válidos.

Para consultar la lista de códigos de error, consulte Códigos de error del servicio.