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

O Database Autonomy Service (DAS) oferece o recurso de inspeção e pontuação. Esse recurso permite inspecionar e pontuar periodicamente a integridade das instâncias, fornecendo informações sobre o status dos bancos de dados. Para mais informações, consulte Inspeção e pontuação.

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:

Esta operação aplica-se apenas a bancos de dados ApsaraDB RDS for MySQL, bancos de dados MySQL autogerenciados em instâncias do Elastic Compute Service (ECS), bancos de dados MySQL autogerenciados em data center local, bancos de dados ApsaraDB for Redis e bancos de dados PolarDB for MySQL.
Ao usar um SDK da Alibaba Cloud, certifique-se de que a versão do aliyun-sdk-core seja superior a 4.3.3. Recomendamos o uso da versão mais recente.
A versão do SDK do DAS deve ser 1.0.3 ou posterior.
Se usar um SDK para chamar o DAS, defina a região como cn-shanghai.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetInstanceInspections	A operação a ser executada. Defina o valor como GetInstanceInspections.
Engine	String	Sim	MySQL	O mecanismo do banco de dados. Valores válidos: MySQL Redis PolarDBMySQL
StartTime	String	Sim	1655416825000	A hora de início da tarefa de inspeção e pontuação. Especifique a hora no formato de timestamp UNIX. Unidade: milissegundos.
EndTime	String	Sim	1655427625000	A hora de término da tarefa de inspeção e pontuação. Especifique a hora no formato de timestamp UNIX. Unidade: milissegundos. Nota A hora de término deve ser posterior à hora de início.
PageNo	String	Sim	1	O número da página a ser retornada. As páginas começam na página 1. Valor padrão: 1.
PageSize	String	Sim	10	O número máximo de entradas a serem retornadas em cada página. Valor padrão: 10.
InstanceArea	String	Sim	RDS	O tipo de instância onde o banco de dados está implantado. Valores válidos: RDS: uma instância de banco de dados da Alibaba Cloud ECS: uma instância ECS com um banco de dados autogerenciado implantado IDC: uma instância de banco de dados autogerenciada não implantada na Alibaba Cloud Nota O valor IDC indica que a instância está implantada em um data center.
SearchMap	String	Não	{"InstanceId":"rm-bp10usoc1erj7****"}	A condição de filtro, especificada em um dos seguintes formatos: Especifique o ID de uma única instância no formato {"InstanceId":"ID da Instância"}. Especifique os IDs de várias instâncias no formato {"InstanceIds":["ID da Instância1","ID da Instância2"]}. Separe os IDs das instâncias com vírgulas (,). Especifique a região onde a instância está localizada no formato {"region":"Região da instância"}.
ResourceGroupId	String	Não	rg-aek2eil6npi****	O ID do grupo de recursos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Message	String	Successful	A mensagem retornada para a solicitação. Nota Se a solicitação for bem-sucedida, Successful será retornado. Se falhar, uma mensagem de erro contendo informações como o código de erro será retornada.
RequestId	String	B6D17591-B48B-4D31-9CD6-9B9796B2****	O ID da solicitação.
Data	Object		Os detalhes do resultado da inspeção e pontuação.
List	Array of BaseInspection		Os detalhes dos resultados de inspeção e pontuação.
EndTime	Long	1608888296001	A hora de término da tarefa de inspeção e pontuação. A hora é um timestamp UNIX. Unidade: milissegundos. Nota A hora de término deve ser posterior à hora de início.
StartTime	Long	1608888296000	A hora de início da tarefa de inspeção e pontuação. A hora é um timestamp UNIX. Unidade: milissegundos.
Data	Map		Os dados retornados.
Instance	Object		Os detalhes da instância.
VpcId	String	vpc-bp1knt7m55z9exoo7****	O ID da virtual private cloud (VPC) onde a instância está implantada.
Uuid	String	hdm_3063db6792965c080a4bcb6e6304****	O identificador exclusivo da instância.
InstanceArea	String	RDS	O tipo de instância onde o banco de dados está implantado. Valores válidos: RDS: uma instância de banco de dados da Alibaba Cloud ECS: uma instância ECS com um banco de dados autogerenciado implantado IDC: uma instância de banco de dados autogerenciada não implantada na Alibaba Cloud Nota O valor IDC indica que a instância está implantada em um data center.
InstanceClass	String	rds.mysql.s2.xlarge	O tipo da instância.
Region	String	cn-hangzhou	O ID da região da instância.
AccountId	String	108398049688****	O ID da conta. Obtenha o ID da conta de logon na página Security Settings no account management center da Alibaba Cloud.
NetworkType	String	VPC	O tipo de rede da instância.
Engine	String	MySQL	O mecanismo do banco de dados. Valores válidos: MySQL Redis PolarDBMySQL
InstanceId	String	rm-bp10usoc1erj7****	O ID da instância.
NodeId	String	rm-bp10usoc1erj7****	O ID do nó na instância.
EngineVersion	String	8.0	O número da versão do mecanismo do banco de dados.
InstanceAlias	String	test-01	O nome da instância.
Cpu	String	8	A especificação de CPU da instância. Por exemplo, se o valor 8 for retornado, a instância possui 8 núcleos de CPU.
Memory	Integer	32768	A capacidade de memória do banco de dados implantado na instância. Unidade: MB.
Storage	Integer	150	O espaço de armazenamento da instância. Unidade: GB.
Category	String	standard	O modo de conexão da instância. Valores válidos: standard: modo padrão safe: modo de proxy de banco de dados
ScoreMap	Map		Os detalhes da pontuação deduzida da instância.
GmtCreate	Long	1603247192000	A hora em que a tarefa foi criada. A hora é um timestamp UNIX. Unidade: milissegundos.
Score	Integer	100	A pontuação de inspeção da instância.
AutoFunction	Object		Indica se o serviço de autonomia está ativado.
EventSubscription	Integer	0	Indica se o recurso de assinatura de eventos está ativado. Valores válidos: 0: desativado 1: ativado 2: não suportado
AutoIndex	Integer	2	Indica se o recurso de criação e exclusão automática de índices está ativado. Valores válidos: 0: desativado 1: ativado 2: não suportado
AutoLimitedSql	Integer	2	Indica se o recurso de limitação automática está ativado. Valores válidos: 0: desativado 1: ativado 2: não suportado
AutoResourceOptimize	Integer	0	Indica se a recuperação automática de fragmentos está ativada. Valores válidos: 0: desativado 1: ativado 2: não suportado
AutoScale	Integer	0	Indica se o recurso de dimensionamento automático está ativado. Valores válidos: 0: desativado 1: ativado 2: não suportado
EnableDasPro	Integer	0	Indica se o DAS Professional Edition está ativado. Valores válidos: 0: desativado 1: ativado 2: não suportado
State	Integer	2	O estado da tarefa de inspeção e pontuação. Valores válidos: 0: A tarefa está aguardando execução. 1: A tarefa está em andamento. 2: A tarefa foi concluída.
TaskType	Integer	0	O modo pelo qual a tarefa de inspeção e pontuação é iniciada. Valores válidos: 0: modo automático 1: modo manual
PageNo	Long	1	O número da página retornada. As páginas começam na página 1. Valor padrão: 1.
PageSize	Long	10	O número máximo de entradas retornadas por página. Valor padrão: 10.
Total	Long	4	O número total de entradas retornadas.
Code	String	200	O código de status HTTP retornado.
Success	String	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true: A solicitação foi bem-sucedida. false: A solicitação falhou.

Exemplos

Solicitações de exemplo

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>

Respostas de sucesso de exemplo

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParams	The request parameters are invalid.	A mensagem de erro retornada porque os parâmetros de solicitação especificados são inválidos.

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