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

Cria uma tarefa de teste de estresse.

Descrição da operação

O Database Autonomy Service (DAS) fornece testes de estresse inteligentes para ajudar você a verificar se o tipo de instância precisa ser expandido para lidar efetivamente com os picos de tráfego do serviço. Para obter mais informações, consulte Teste de estresse inteligente. O banco de dados deve atender aos seguintes pré-requisitos:

O banco de dados de origem suporta apenas o RDS MySQL High Availability Edition ou RDS Enterprise Edition, e o PolarDB MySQL cluster edition.
A instância de banco de dados de destino é RDS MySQL ou PolarDB MySQL.
A instância está conectada ao DAS. Para obter mais informações, consulte Conectar a instâncias de banco de dados do Alibaba Cloud.
O DAS Enterprise Edition deve estar ativado. Para obter mais informações, consulte DAS Enterprise Edition.

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

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TaskType	string	Sim	O tipo de tarefa de teste de estresse. Valores válidos: pressure test (padrão): Teste de estresse inteligente, que reproduz o tráfego capturado da instância de origem na instância de destino na velocidade máxima suportada pelo tipo de instância de destino. smart pressure test: Teste de estresse gerado, que analisa e aprende com o tráfego capturado da instância de origem em um curto período de tempo, gera tráfego consistente com o modelo de negócios e a distribuição de tráfego do tráfego original para testes de estresse contínuos, reduz o tempo de coleta de dados da instância de origem e reduz os custos de armazenamento e a sobrecarga de desempenho.	pressure test
SrcInstanceId	string	Sim	O ID da instância de origem. Apenas instâncias RDS MySQL e PolarDB MySQL são suportadas. Você pode chamar a operação GetInstanceInspections para obter o ID. Nota Este parâmetro é obrigatório quando DstType é definido como Instance.	rm-2ze1jdv45i7l6****
Description	string	Sim	A descrição da tarefa de teste de estresse.	test-das-bench-0501
SrcPublicIp	string	Não	Parâmetro reservado.	None
DstInstanceId	string	Não	O ID da instância de destino. Apenas instâncias RDS MySQL e PolarDB MySQL são suportadas. Você pode chamar a operação GetInstanceInspections para obter o ID. Nota Este parâmetro é obrigatório quando DstType é definido como Instance.	rm-2ze1jdv45i7l6****
GatewayVpcId	string	Não	O ID da Virtual Private Cloud (VPC) do Database Gateway. Nota Este parâmetro é obrigatório quando ClientType é definido como ECS.	vpc-t4nsnwvpbc1h76ja4****
GatewayVpcIp	string	Não	O endereço IP ou nome de domínio do Database Gateway. Nota Este parâmetro é obrigatório quando ClientType é definido como ECS.	172.30.XX.XX
ClientType	string	Sim	O tipo de máquina de teste de estresse. Valores válidos: ECS: Você precisa preparar um Database Gateway por conta própria. DAS_ECS: Uma instância ECS que é comprada e implantada automaticamente pelo DAS.	ECS
RequestStartTime	string	Não	O horário de início da tarefa de teste de estresse. O horário está no formato de timestamp UNIX. Unidade: milissegundos.	1608888296000
RequestEndTime	string	Não	O horário de término da tarefa de teste de estresse. O horário está no formato de timestamp UNIX. Unidade: milissegundos.	1608888296001
RequestDuration	string	Não	A duração da tarefa de teste de estresse. Unidade: milissegundos.	86400000
Rate	string	Não	A velocidade de reprodução do tráfego da instância de origem na instância de destino. A velocidade de reprodução deve ser um número inteiro positivo. Valores válidos: 1 a 30. Valor padrão: 1.	1
SmartPressureTime	string	Não	A duração do teste de estresse gerado. Unidade: milissegundos. Nota Este parâmetro é obrigatório quando TaskType é definido como smart pressure test.	86400000
DtsJobClass	string	Não	A especificação da tarefa de migração do DTS. Você pode chamar a operação DescribeCloudbenchTask para obter a especificação. Nota A tarefa de teste de estresse precisa migrar os dados de linha de base da instância de origem para a instância de destino. Este parâmetro é obrigatório quando você cria uma nova tarefa do DTS.	medium
DtsJobId	string	Não	O ID da tarefa de migração do DTS. Você pode chamar a operação ConfigureDtsJob para obter o ID. Nota Este parâmetro é obrigatório quando uma tarefa do DTS foi criada no console do DTS.	23127
SrcSuperAccount	string	Não	A conta privilegiada da instância de origem. Valor: admin. Nota Este parâmetro é obrigatório quando DstType é definido como Instance.	admin
SrcSuperPassword	string	Não	A senha da conta privilegiada da instância de origem. Nota Este parâmetro é obrigatório quando DstType é definido como Instance.	test123
DstSuperAccount	string	Não	A conta privilegiada da instância de destino.	root
DstSuperPassword	string	Não	A senha da conta privilegiada da instância de destino.	test123
DstType	string	Não	O tipo da instância de destino. Valores válidos: Instance (padrão): ID da instância. ConnectionString: endereço de conexão da instância.	Instance
DstConnectionString	string	Não	O endereço de conexão da instância de destino. Apenas instâncias RDS MySQL e PolarDB MySQL são suportadas. Nota Este parâmetro entra em vigor quando DstType é definido como ConnectionString.	rm-de21209****.mysql.rds.aliyuncs.com
DstPort	string	Não	A porta da instância de destino. Nota Este parâmetro entra em vigor quando DstType é definido como ConnectionString.	3306
WorkDir	string	Não	O diretório temporário gerado pelo teste de estresse.	/tmp/bench/
BackupId	string	Não	O ID do conjunto de backups. Você pode chamar a operação DescribeBackups para consultar a lista de backups e obter o ID.	229132
BackupTime	string	Não	O horário do backup. Formato: yyyy-MM-ddTHH:mm:ssZ (horário UTC).	2021-04-23T13:22:14Z
Amount	string	Não	O número total de tarefas de teste de estresse a serem criadas. Valores válidos: 0 a 30. Valor padrão: 1.	1
EndState	string	Não	O status após o término da tarefa de teste de estresse. Valores válidos: WAIT_TARGET: Preparar a instância de destino para o teste de estresse. WAIT_DBGATEWAY: Preparar a implantação do teste de estresse. WAIT_SQL: Preparar as instruções SQL completas. WAIT_LOGIC: Preparar para iniciar a reprodução do tráfego. Nota Quando a tarefa de teste de estresse conclui o status definido por EndState, a tarefa atinge diretamente o status de concluída.	WAIT_TARGET

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
Code	string	O código de status retornado.	200
Message	string	A mensagem retornada. Nota Quando a solicitação é bem-sucedida, Successful é retornado. Quando a solicitação falha, informações de exceção, como um código de erro, são retornadas.	Successful
RequestId	string	O ID da solicitação.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	Indica se a solicitação foi bem-sucedida: true: A solicitação foi bem-sucedida. false: A solicitação falhou.	true
Data	object
taskIds	array	A lista de detalhes.
	string	A lista de detalhes, incluindo o número total de itens de informação, códigos de erro e outras informações.	"Data": { "total": 1, "list":[...] }, "Code": 200, "Success": true }

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": {
    "taskIds": [
      "\"Data\": { \"total\": 1, \"list\":[...] }, \"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.
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.