DescribeDBClusterPerformance - AnalyticDB: Central de Documentação do Alibaba Cloud

Consulta os dados de desempenho de um cluster especificado.

Descrição da operação

Para o endpoint deste serviço, consulte Endpoint.

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

adb:DescribeDBClusterPerformance

list

*DBClusterLakeVersion.

acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBClusterId	string	Sim	O ID do cluster da Data Lakehouse Edition. Nota Você pode chamar a operação DescribeDBClusters para consultar os IDs de todos os clusters em uma região especificada.	amv-bp1hx5n1o8f61****
Key	string	Não	O nome da métrica de desempenho (chave da métrica) a ser consultada. Separe vários valores com vírgulas (,). Para obter mais informações sobre as métricas suportadas, consulte Visão geral das métricas de monitoramento.	AnalyticDB_CPU_Usage_Percentage
StartTime	string	Não	A hora de início da consulta. Especifique a hora em UTC no formato yyyy-MM-ddTHH:mmZ.	2022-03-10T23:56Z
EndTime	string	Não	A hora de término da consulta. Especifique a hora em UTC no formato yyyy-MM-ddTHH:mmZ. Nota A hora de término deve ser posterior à hora de início, e o intervalo entre a hora de início e a hora de término não pode exceder dois dias.	2022-03-11T15:01Z
RegionId	string	Sim	O ID da região. Nota Você pode chamar a operação DescribeRegions para consultar as regiões e zonas suportadas pelo AnalyticDB for MySQL, incluindo os IDs das regiões.	cn-hangzhou
ResourcePools	string	Não	O grupo de recursos.	user_default

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
EndTime	string	A hora de término da consulta. A hora está em UTC no formato yyyy-MM-ddTHH:mmZ.	2022-03-11T15:01Z
RequestId	string	O ID da solicitação.	BD8C3096-8BC6-51DF-A4AB-BACD9DC10435
StartTime	string	A hora de início da consulta. Especifique a hora em UTC no formato yyyy-MM-ddTHH:mmZ.	2022-03-10T23:56Z
DBClusterId	string	O ID do cluster. Nota Você pode chamar a operação DescribeDBClusters para consultar os IDs de todos os clusters em uma região especificada.	amv-bp1hx5n1o8f61****
Performances	array<object>	A lista de métricas de desempenho do cluster.
	array<object>	A lista.
Key	string	O nome da métrica de desempenho.	AnalyticDB_CPU_Usage_Percentage
Unit	string	A unidade da métrica de monitoramento.	%
Series	array<object>	A lista de dados de desempenho.
	object	A lista.
Values	array	Os valores de desempenho em diferentes pontos no tempo.
	string	Os valores de desempenho em diferentes pontos no tempo.	[ [ "2023-06-27T13:21:00+08:00","0.1250" ], [ "2022-03-11T10:00:42.739Z","0.3125" ]... ]
Name	string	O nome da métrica de desempenho (nome do valor da métrica de monitoramento). Para obter mais informações, consulte Visão geral das métricas de monitoramento.	AnalyticDB_Storage_CPU_Avg_Usage_Percentage
Tags	string	O valor da tag.	{instance_name: "am-***"}
TranslateKey	string	A chave usada para tradução de internacionalização. Você pode ignorar este parâmetro na maioria dos casos.	AnalyticDB_RP_WaitTime

Exemplos

Resposta de sucesso

JSON formato

{
  "EndTime": "2022-03-11T15:01Z",
  "RequestId": "BD8C3096-8BC6-51DF-A4AB-BACD9DC10435",
  "StartTime": "2022-03-10T23:56Z",
  "DBClusterId": "amv-bp1hx5n1o8f61****",
  "Performances": [
    {
      "Key": "AnalyticDB_CPU_Usage_Percentage",
      "Unit": "%",
      "Series": [
        {
          "Values": [
            "[\n  [ \n  \"2023-06-27T13:21:00+08:00\",\"0.1250\" \n  ], \n  [ \n  \"2022-03-11T10:00:42.739Z\",\"0.3125\" \n  ]...\n]"
          ],
          "Name": "AnalyticDB_Storage_CPU_Avg_Usage_Percentage",
          "Tags": "\n{instance_name: \"am-***\"}",
          "TranslateKey": "AnalyticDB_RP_WaitTime"
        }
      ]
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.