DescribeAutoScalingHistory - Database Autonomy Service: Central de Documentação do Alibaba Cloud

Consulta o histórico de dimensionamento automático de uma instância.

Descrição da operação

Suporta a consulta do histórico de dimensionamento automático de desempenho apenas para instâncias da High-availability Edition do ApsaraDB RDS for MySQL que utilizam discos em nuvem.
Se você usar um SDK do Alibaba Cloud ou um SDK do Database Autonomy Service (DAS) para chamar esta operação, recomendamos que use a versão mais recente do SDK.
Se você usar um SDK para chamar operações do DAS, deverá definir o ID da região como cn-shanghai.

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

hdm:DescribeAutoScalingHistory

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância. Nota Somente instâncias do ApsaraDB RDS for MySQL são suportadas.	rm-2ze8g2am97624****
AutoScalingTaskType	string	Sim	O tipo de tarefa de dimensionamento automático que você deseja consultar. Defina o valor como SPEC, o que indica que você pode consultar apenas o histórico de tarefas de dimensionamento automático de desempenho.	SPEC
StartTime	integer	Sim	O início do intervalo de tempo a ser consultado. Defina este parâmetro como um carimbo de data/hora UNIX que representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC. Nota O intervalo de tempo máximo que pode ser especificado é de 45 dias.	1675833788056
EndTime	integer	Sim	O fim do intervalo de tempo a ser consultado. Defina este parâmetro como um carimbo de data/hora UNIX que representa o número de milissegundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC. Nota O horário de término deve ser posterior ao horário de início.	1676605305796

Se você definir AutoScalingTaskType como SPEC, o histórico de tarefas de dimensionamento automático de desempenho será consultado. Somente SPEC é suportado.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
Code	string	O código de status HTTP retornado. O código de status 200 indica que a solicitação foi bem-sucedida.	200
Message	string	A mensagem retornada. Nota Se a solicitação foi bem-sucedida, Successful é retornado. Caso contrário, uma mensagem de erro, como um código de erro, é retornada.	Successful
RequestId	string	O ID da solicitação.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	Indica se a solicitação foi bem-sucedida. Valores válidos: true false	true
Data	object	O histórico de dimensionamento automático.
InstanceId	string	O ID da instância.	rm-2ze1jdv45i7l6****
SpecHistory	array<object>	O histórico de dimensionamento automático de desempenho.
	object
ScaleType	string	The type of the automatic performance scaling task. Valid values: SCALE_UP: automatic instance type scale-up task. SCALE_DOWN: automatic instance type scale-down task.	SCALE_UP
TaskExcuteStatus	boolean	The status of the task. Valid values: true: The task was successful. false: The task failed.	true
ErrorCode	string	The error code returned by the scaling task. Valid values: Insufficient_Balance: The account has insufficient balance or an unpaid order. REACH_SPEC_UPPERBOUND: The instance type reaches the upper limit. Control_Error_Timeout_Msg: The management task timed out. Invoke_Rds_Api_Error_Msg: Failed to call the ApsaraDB RDS API.	Insufficient_Balance
OriginInstanceClass	string	The original instance type.	mysql.n2.large.2c
TargetInstanceClass	string	The destination instance type.	mysql.n2.xlarge.2c
OriginCore	integer	The original number of CPU cores of the instance.	4
OriginMemory	number	The original memory size of the instance. Unit: GB.	8
TargetCore	integer	The destination number of CPU cores of the instance.	8
TargetMemory	number	The destination memory size of the instance. Unit: GB.	16
TaskTime	integer	The time when the task was run. Set this parameter to a UNIX timestamp representing the number of milliseconds that have elapsed since January 1, 1970, 00:00:00 UTC.	1684830763000
Storage	array<object>	O histórico de expansão de armazenamento. Este recurso não é suportado.
	object	O histórico de expansão de armazenamento da instância.	None
Resource	array<object>	O histórico de scale-out de recursos de instâncias do ApsaraDB for Redis. Este recurso não é suportado.
	object	O histórico de scale-out de recursos da instância do ApsaraDB for Redis.	None
Shard	array<object>	O histórico de scale-out automático de shards de instâncias do ApsaraDB for Redis. Este recurso não é suportado.
	object	O histórico de scale-out automático de shards da instância do ApsaraDB for Redis.	None
Bandwidth	array<object>	O histórico de dimensionamento automático de largura de banda de instâncias do ApsaraDB for Redis. Este recurso não é suportado.
	object	O histórico de dimensionamento automático de largura de banda da instância do ApsaraDB for Redis.	None

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": {
    "InstanceId": "rm-2ze1jdv45i7l6****",
    "SpecHistory": [
      {
        "ScaleType": "SCALE_UP",
        "TaskExcuteStatus": true,
        "ErrorCode": "Insufficient_Balance",
        "OriginInstanceClass": "mysql.n2.large.2c",
        "TargetInstanceClass": "mysql.n2.xlarge.2c",
        "OriginCore": 4,
        "OriginMemory": 8,
        "TargetCore": 8,
        "TargetMemory": 16,
        "TaskTime": 1684830763000
      }
    ],
    "Storage": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "Resource": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "Shard": [
      {
        "test": "test",
        "test2": 1
      }
    ],
    "Bandwidth": [
      {
        "test": "test",
        "test2": 1
      }
    ]
  }
}

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.
403	NoPermission	You are not authorized to do this action.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.