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

Configura assincronamente os parâmetros relacionados ao recurso de reciclagem automática de fragmentos para várias instâncias de banco de dados simultaneamente.

Descrição da operação

Nota

As chamadas assíncronas não retornam imediatamente os resultados completos. Para obter os resultados completos, você deve usar o valor de ResultId retornado na resposta para reiniciar a chamada até que o valor de isFinish seja true. Nesse caso, você deve chamar esta operação pelo menos duas vezes.

Antes de chamar esta operação, observe os seguintes itens:

Se você usar um SDK para chamar as operações de API do Database Autonomy Service (DAS), deverá definir o ID da região como cn-shanghai.
As instâncias de banco de dados devem ser instâncias do ApsaraDB RDS for MySQL High-availability Edition.
O DAS Enterprise Edition deve estar ativado para a instância de banco de dados. Você pode chamar a operação DescribeInstanceDasPro para consultar se o DAS Enterprise Edition está ativado.
A instância de banco de dados possui quatro ou mais núcleos de CPU e innodb_file_per_table está definido como ON.

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:UpdateAutoResourceOptimizeRulesAsync

none

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ConsoleContext	string	Não	O parâmetro reservado.	None
InstanceIds	string	Sim	Os IDs das instâncias de banco de dados. Nota Defina este parâmetro como um array JSON que consiste em vários IDs de instância. Separe os IDs de instância com vírgulas (,). Exemplo: `['Instance ID1', 'Instance ID2']`.	['rm-2ze8g2am97624**','rm-2ze9xrhze0709**']
TableSpaceSize	number	Sim	O uso mínimo de armazenamento que aciona a reciclagem automática de fragmentos de uma única tabela física. Valores válidos: 5 a 100. Unidade: GB.	10
TableFragmentationRatio	number	Sim	A taxa de fragmentação que aciona a reciclagem automática de fragmentos de uma única tabela física. Valores válidos: 0.10 a 0.99.	0.2
ResultId	string	Não	O ID da solicitação assíncrona. Nota As chamadas assíncronas não retornam imediatamente os resultados completos. Para obter os resultados completos, você deve usar o valor de ResultId retornado na resposta para reiniciar a chamada até que o valor de isFinish seja true. Nesse caso, você deve chamar esta operação pelo menos duas vezes.	async__507044db6c4eadfa2dab9b084e80****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
Code	integer	O código de status HTTP retornado.	200
Message	string	A mensagem retornada. Nota Se a solicitação for bem-sucedida, Successful será retornado. Se a solicitação falhar, uma mensagem de erro, como um código de erro, será retornada.	Successful
Data	object	Os dados retornados.
Fail	boolean	Indica se a solicitação assíncrona falhou. Valores válidos: true false	false
ConfigResponse	object	Os dados retornados da configuração. Nota Os dados são retornados apenas se o valor de isFinish for true. Este valor indica que a solicitação assíncrona foi concluída.
TotalInstanceCount	integer	The total number of database instances.	2
ConfigSuccessInstanceCount	integer	The number of database instances for which the parameters are configured.	1
ConfigFailInstanceCount	integer	The number of database instances for which the parameters failed to be configured.	1
ConfigSuccessInstanceList	array<object>	The database instances for which the parameters are configured.
	object
ConfigSuccess	boolean	Indicates whether the parameters are configured. Valid values: true false	true
InstanceId	string	The database instance ID.	rm-2ze8g2am97624****
ConfigFailInstanceList	array<object>	The database instances for which the parameters failed to be configured.
	object
ConfigSuccess	boolean	Indicates whether the parameters are configured. Valid values: true false	false
InstanceId	string	The database instance ID.	rm-2ze9xrhze0709****
ErrorMessage	string	The error message returned.	Only Support DAS Pro High-availability Edition RDS MySQL 5.6, 5.7, 8.0 instance, and CPU cores >= 4, innodb_file_per_table=ON
ResultId	string	O ID da solicitação assíncrona.	async__20ee808e72257f16a4fe024057ca****
IsFinish	boolean	Indica se a solicitação assíncrona foi concluída. Valores válidos: true false	true
State	string	O estado da solicitação assíncrona. Valores válidos: RUNNING SUCCESS FAIL	SUCCESS
Complete	boolean	Indica se a solicitação assíncrona foi concluída. Valores válidos: true false	true
Timestamp	integer	A hora em que a solicitação assíncrona foi feita. Este valor é um carimbo de data/hora UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.	1645668213000
RequestId	string	O ID da solicitação.	9CB97BC4-6479-55D0-B9D0-EA925AFE****
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true false	true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": 200,
  "Message": "Successful",
  "Data": {
    "Fail": false,
    "ConfigResponse": {
      "TotalInstanceCount": 2,
      "ConfigSuccessInstanceCount": 1,
      "ConfigFailInstanceCount": 1,
      "ConfigSuccessInstanceList": [
        {
          "ConfigSuccess": true,
          "InstanceId": "rm-2ze8g2am97624****"
        }
      ],
      "ConfigFailInstanceList": [
        {
          "ConfigSuccess": false,
          "InstanceId": "rm-2ze9xrhze0709****",
          "ErrorMessage": "Only Support DAS Pro High-availability Edition RDS MySQL 5.6, 5.7, 8.0 instance, and CPU cores >= 4, innodb_file_per_table=ON"
        }
      ]
    },
    "ResultId": "async__20ee808e72257f16a4fe024057ca****",
    "IsFinish": true,
    "State": "SUCCESS",
    "Complete": true,
    "Timestamp": 1645668213000
  },
  "RequestId": "9CB97BC4-6479-55D0-B9D0-EA925AFE****",
  "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.
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.