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

Consulta a lista de tarefas de teste de estresse.

Descrição da operação

O Database Autonomy Service (DAS) fornece recursos inteligentes de teste de estresse para ajudar você a verificar se as especificações da sua instância precisam ser escalonadas para lidar efetivamente com picos de tráfego de serviço. Para mais informações, consulte Teste de estresse inteligente.

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

get

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Status	string	Não	O status de execução da tarefa. Valores válidos: SUCCESS: Sucesso. IGNORED: Ignorado. RUNNING: Em execução. EXCEPTION: Exceção.	SUCCESS
TaskType	string	Não	O tipo da tarefa de teste de estresse. Valores válidos: pressure test (padrão): teste de estresse inteligente. O tráfego capturado da instância de origem é reproduzido na instância de destino na velocidade máxima suportada pelas especificações da instância de destino. smart pressure test: teste de estresse gerado. Ao analisar e aprender com o tráfego capturado da instância de origem em um curto período, é gerado um 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. Isso reduz o tempo necessário para coletar dados da instância de origem e diminui os custos de armazenamento e a sobrecarga de desempenho.	pressure test
StartTime	string	Não	A hora de início da tarefa de consulta. Especifique o valor como um timestamp UNIX. Unidade: milissegundos.	1596177993000
EndTime	string	Não	A hora de término da tarefa de consulta. Especifique o valor como um timestamp UNIX. Unidade: milissegundos. Nota A hora de término da tarefa de consulta deve ser posterior à hora de início.	1596177993001
PageNo	string	Não	O número da página. O valor deve ser maior que 0 e não pode exceder o valor máximo do tipo de dados Integer. Valor padrão: 1.	1
PageSize	string	Não	O número máximo de registros por página. O valor deve ser maior que 0 e não pode exceder o valor máximo do tipo de dados Integer. Valor padrão: 10.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status 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
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: A solicitação foi bem-sucedida. false: A solicitação falhou.	true
Data	object	A lista de informações detalhadas, incluindo o número total de entradas e códigos de erro.
PageNo	integer	O número da página.	1
PageSize	integer	O número máximo de registros por página.	10
Extra	string	O parâmetro reservado.	None
Total	integer	O número total de resultados.	2
List	object
cloudbenchTasks	array<object>	A lista de informações detalhadas sobre as tarefas de teste de estresse.
	object
DtsJobName	string	O nome da tarefa do Data Transmission Service (DTS).	Migração entre instâncias RDS
ErrorMessage	string	A mensagem de erro retornada quando a tarefa falha.	DTS-070211: Falha ao conectar ao banco de dados de origem. Causado por [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Não foi possível criar conexão com o servidor de banco de dados. Tentativa de reconexão 3 vezes. Desistindo.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Falha no link de comunicações\n\nO último pacote enviado com sucesso ao servidor foi há 0 milissegundos. O driver não recebeu nenhum pacote do servidor.][java.net.ConnectException:Tempo limite de conexão esgotado (Tempo limite de conexão esgotado)] Para mais informações, consulte [https://yq.aliyun.com/articles/499178]
External	string	As informações adicionais.	Null
BackupType	string	O tipo de backup. Valores válidos: TIMESTAMP: por hora de backup. BACKUPID: por ID do conjunto de backup.	TIMESTAMP
UserId	string	O ID da conta Alibaba Cloud.	1091411816252****
DstType	string	O tipo da instância de destino. Valores válidos: Instance (padrão): ID da instância. ConnectionString: endpoint da instância.	Instance
EcsInstanceId	string	O ID da instância ECS.	i-bp1ecr5go2go1****
DstInstanceUuid	string	A identidade única da instância de destino.	hdm_d887b5ccf99fa0dc9a1e5aaac368****
TaskType	string	O tipo da tarefa de teste de estresse. Valores válidos: pressure test (padrão): teste de estresse inteligente. O tráfego capturado da instância de origem é reproduzido na instância de destino na velocidade máxima suportada pelas especificações da instância de destino. smart pressure test: teste de estresse gerado. Ao analisar e aprender com o tráfego capturado da instância de origem em um curto período, é gerado um 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. Isso reduz o tempo necessário para coletar dados da instância de origem e diminui os custos de armazenamento e a sobrecarga de desempenho.	pressure test
BenchStep	string	A subetapa da tarefa de teste de estresse. Valores válidos: NEW: inicialização da tarefa. WAIT_BUY_ECS: comprando uma nova instância ECS. WAIT_START_ECS: iniciando a instância ECS. WAIT_INSTALL_JDK: instalando JDK. WAIT_INSTALL_DBGATEWAY: instalando DBGateway. ADD_SECURITY_IPS_STEP: configurando lista de permissões do grupo de segurança. ARCHIVE: arquivamento completo de SQL. DOWNLOAD: baixando arquivos SQL completos. PROCEED: pré-processando arquivos SQL completos. PRE_LOAD: pré-carregando arquivos SQL completos. VALIDATE: validação funcional. PRESSURE: teste de estresse de desempenho.	PROCEED
Version	string	A versão da tarefa de teste de estresse. Valores válidos: V2.0. V3.0.	V3.0
EndState	string	O status após o término da tarefa de teste de estresse. Valores válidos: WAIT_TARGET: preparando a instância de destino para o teste de estresse. WAIT_DBGATEWAY: preparando a implantação do teste de estresse. WAIT_SQL: preparando SQL completo. WAIT_LOGIC: preparando para iniciar a reprodução de tráfego. Nota Após a tarefa de teste de estresse executar o estado especificado nas configurações de EndState, a tarefa atinge diretamente o estado concluído.	WAIT_TARGET
SrcInstanceUuid	string	O identificador único da instância de origem.	hdm_3063db6792965c080a4bcb6e6304****
ClientType	string	O tipo da 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 comprada e implantada automaticamente pelo DAS.	ECS
State	string	O status atual da tarefa de teste de estresse. Valores válidos: WAIT_TARGET: preparando a instância de destino para o teste de estresse. WAIT_DBGATEWAY: preparando a implantação do teste de estresse. WAIT_SQL: preparando SQL completo. WAIT_LOGIC: preparando para iniciar a reprodução de tráfego.	WAIT_TARGET
DstIp	string	O parâmetro reservado.	None
SrcPublicIp	string	O parâmetro reservado.	None
BackupId	string	O ID do conjunto de backup. Você pode obter esse valor chamando a operação DescribeBackups.	229132
SqlCompleteReuse	string	As informações de reutilização do SQL completo.	{"sqlUuid":"task_a37d2f07-45cb-4413-a2a6-c66c68**","metaUuid":"task_211e2561-5c0c-486b-864c-56b511**","sqlFile":"cl-1620057600000-1800626.sc","metaFile":"cl-1620057600000-1800626.meta"}
SmartPressureTime	integer	A duração do teste de estresse gerado. Unidade: milissegundos.	86400000
ArchiveState	integer	O status de arquivamento de SQL. Valores válidos: 0: não iniciado. 1: concluído. 2: erro. 3: em execução. 4: nenhum download necessário.	1
Status	string	O status de execução da tarefa de teste de estresse. Valores válidos: SUCCESS: Sucesso. IGNORED: Ignorado. RUNNING: Em execução. EXCEPTION: Exceção.	RUNNING
WorkDir	string	O diretório temporário gerado pela tarefa de teste de estresse.	/tmp/bench/
ArchiveOssTableName	string	O nome da tabela arquivada no OSS.	custins15546355_161604665****
DtsJobId	string	O ID da tarefa de migração do DTS.	i03e3zty16i****
DtsJobState	integer	O status da tarefa do DTS. Valores válidos: NOT_STARTED: não iniciado. PRE_CHECKING: pré-verificação. PRE_CHECK_FAILED: falha na pré-verificação. CHECKING: verificando. MIGRATING: migrando. CATCHED: sincronizado. SUSPENDING: suspendendo. MIGRATION_FAILED: falha na migração. FINISHED: concluído. INITIALIZING: inicializando sincronização. INITIALIZE_FAILED: falha na inicialização da sincronização. SYNCHRONIZING: sincronizando. MODIFYING: modificando objetos de sincronização. SWITCHING: alternando. FAILED: falhou.	CHECKING
DstPort	integer	A porta da instância de destino.	3306
DtsJobClass	string	A especificação do link do DTS. Nota Para mais informações sobre especificações de link e resultados de testes de desempenho, consulte Especificações de link de migração de dados.	medium
ClientGatewayId	string	O ID do Database Gateway da máquina de teste de estresse.	58598b2af48a0193dfc16fc6964ef****
Description	string	A descrição da tarefa de teste de estresse.	test-das-bench-0501
ErrorCode	string	O código de erro retornado pela tarefa interna de teste de estresse.	10109
TableSchema	string	Os nomes das tabelas envolvidas no teste de estresse.	[{"TABLE_NAME":"customer1","TABLE_SCHEMA":"tpcc"}]
DtsJobStatus	string	O status da tarefa do DTS. Valores válidos: NOT_STARTED: não iniciado. PRE_CHECKING: pré-verificação. PRE_CHECK_FAILED: falha na pré-verificação. CHECKING: verificando. MIGRATING: migrando. CATCHED: sincronizado. SUSPENDING: suspendendo. MIGRATION_FAILED: falha na migração. FINISHED: concluído. INITIALIZING: inicializando sincronização. INITIALIZE_FAILED: falha na inicialização da sincronização. SYNCHRONIZING: sincronizando. MODIFYING: modificando objetos de sincronização. SWITCHING: alternando. FAILED: falhou.	PRE_CHECK_FAILED
SrcInstanceArea	string	O tipo de banco de dados da instância de origem.	RDS
BenchStepStatus	string	O status da subetapa do teste de estresse. Valores válidos: NEW: inicialização da tarefa. RUNNING: em execução. FAILED: falhou. FINISHED: concluído. Terminated: encerrado. Deleted: excluído.	FINISHED
Source	string	A origem da tarefa. Valores válidos: DAS. OPEN_API.	DAS
ArchiveJobId	string	O ID da tarefa de arquivamento.	'202105211430070112231480820340758****
Topic	string	O tópico de consumo do Kafka.	das
RequestDuration	integer	A duração da tarefa de teste de estresse. Unidade: milissegundos.	86400000
TaskId	string	O ID da tarefa.	e5cec704-0518-430f-8263-76f4dcds****
Rate	integer	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: 0 a 30. Valor padrão: 1.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": {
    "PageNo": 1,
    "PageSize": 10,
    "Extra": "None",
    "Total": 2,
    "List": {
      "cloudbenchTasks": [
        {
          "DtsJobName": "RDS间迁移",
          "ErrorMessage": "DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\\n\\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].",
          "External": "Null",
          "BackupType": "TIMESTAMP",
          "UserId": "1091411816252****",
          "DstType": "Instance",
          "EcsInstanceId": "i-bp1ecr5go2go1****",
          "DstInstanceUuid": "hdm_d887b5ccf99fa0dc9a1e5aaac368****",
          "TaskType": "pressure test",
          "BenchStep": "PROCEED",
          "Version": "V3.0",
          "EndState": "WAIT_TARGET",
          "SrcInstanceUuid": "hdm_3063db6792965c080a4bcb6e6304****",
          "ClientType": "ECS",
          "State": "WAIT_TARGET",
          "DstIp": "None",
          "SrcPublicIp": "None",
          "BackupId": "229132",
          "SqlCompleteReuse": "{\"sqlUuid\":\"task_a37d2f07-45cb-4413-a2a6-c66c68****\",\"metaUuid\":\"task_211e2561-5c0c-486b-864c-56b511****\",\"sqlFile\":\"cl-1620057600000-1800626.sc\",\"metaFile\":\"cl-1620057600000-1800626.meta\"}",
          "SmartPressureTime": 86400000,
          "ArchiveState": 1,
          "Status": "RUNNING",
          "WorkDir": "/tmp/bench/",
          "ArchiveOssTableName": "custins15546355_161604665****",
          "DtsJobId": "i03e3zty16i****",
          "DtsJobState": 0,
          "DstPort": 3306,
          "DtsJobClass": "medium",
          "ClientGatewayId": "58598b2af48a0193dfc16fc6964ef****",
          "Description": "test-das-bench-0501",
          "ErrorCode": "10109",
          "TableSchema": "[{\"TABLE_NAME\":\"customer1\",\"TABLE_SCHEMA\":\"tpcc\"}]",
          "DtsJobStatus": "PRE_CHECK_FAILED",
          "SrcInstanceArea": "RDS",
          "BenchStepStatus": "FINISHED",
          "Source": "DAS",
          "ArchiveJobId": "'202105211430070112231480820340758****",
          "Topic": "das",
          "RequestDuration": 86400000,
          "TaskId": "e5cec704-0518-430f-8263-76f4dcds****",
          "Rate": 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.	Os parâmetros da solicitação são inválidos.
403	NoPermission	You are not authorized to do this action.	Você não tem as permissões para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.