CreateCloudBenchTasks - Database Autonomy Service - Centro de documentación de Alibaba Cloud

Puede llamar a la operación CreateCloudBenchTasks para crear una tarea de prueba de estrés.

Descripción de la operación

Database Autonomy Service (DAS) proporciona pruebas de estrés inteligentes para ayudarle a verificar si necesita escalar horizontalmente el tipo de instancia para manejar eficazmente los picos de tráfico del servicio. Para obtener más información, consulte Pruebas de estrés inteligentes. La base de datos debe cumplir con los siguientes requisitos previos:

La base de datos de origen solo admite RDS MySQL High Availability Edition o RDS Enterprise Edition, y PolarDB MySQL cluster edition.
La instancia de base de datos de destino es RDS MySQL o PolarDB MySQL.
La instancia está conectada a DAS. Para obtener más información, consulte Conectar instancias de bases de datos de Alibaba Cloud.
Debe estar habilitada la edición DAS Enterprise. Para obtener más información, consulte DAS Enterprise Edition.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

hdm:CreateCloudBenchTasks

create

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
TaskType	string	Sí	El tipo de tarea de prueba de estrés. Valores válidos: pressure test (predeterminado): Prueba de estrés inteligente, que reproduce el tráfico capturado de la instancia de origen en la instancia de destino a la velocidad máxima admitida por el tipo de instancia de destino. smart pressure test: Prueba de estrés generada, que analiza y aprende del tráfico capturado de la instancia de origen en un corto período de tiempo, genera tráfico consistente con el modelo de negocio y la distribución de tráfico del tráfico original para realizar pruebas de estrés continuas, reduce el tiempo de recopilación de datos de la instancia de origen y disminuye los costos de almacenamiento y la sobrecarga de rendimiento.	pressure test
SrcInstanceId	string	Sí	El ID de la instancia de origen. Solo se admiten instancias RDS MySQL y PolarDB MySQL. Puede llamar a la operación GetInstanceInspections para obtener el ID. Nota Este parámetro es obligatorio cuando DstType se establece en Instance.	rm-2ze1jdv45i7l6****
Description	string	Sí	La descripción de la tarea de prueba de estrés.	test-das-bench-0501
SrcPublicIp	string	No	Parámetro reservado.	None
DstInstanceId	string	No	El ID de la instancia de destino. Solo se admiten instancias RDS MySQL y PolarDB MySQL. Puede llamar a la operación GetInstanceInspections para obtener el ID. Nota Este parámetro es obligatorio cuando DstType se establece en Instance.	rm-2ze1jdv45i7l6****
GatewayVpcId	string	No	El ID de la nube privada virtual (VPC) de Database Gateway. Nota Este parámetro es obligatorio cuando ClientType se establece en ECS.	vpc-t4nsnwvpbc1h76ja4****
GatewayVpcIp	string	No	La dirección IP o el nombre de dominio de Database Gateway. Nota Este parámetro es obligatorio cuando ClientType se establece en ECS.	172.30.XX.XX
ClientType	string	Sí	El tipo de máquina de prueba de estrés. Valores válidos: ECS: Debe preparar un Database Gateway por su cuenta. DAS_ECS: Una instancia ECS que DAS compra y despliega automáticamente.	ECS
RequestStartTime	string	No	La hora de inicio de la tarea de prueba de estrés. La hora está en formato de marca de tiempo UNIX. Unidad: milisegundos.	1608888296000
RequestEndTime	string	No	La hora de finalización de la tarea de prueba de estrés. La hora está en formato de marca de tiempo UNIX. Unidad: milisegundos.	1608888296001
RequestDuration	string	No	La duración de la tarea de prueba de estrés. Unidad: milisegundos.	86400000
Rate	string	No	La velocidad de reproducción del tráfico de la instancia de origen en la instancia de destino. La velocidad de reproducción debe ser un número entero positivo. Valores válidos: 1 a 30. Valor predeterminado: 1.	1
SmartPressureTime	string	No	La duración de la prueba de estrés generada. Unidad: milisegundos. Nota Este parámetro es obligatorio cuando TaskType se establece en smart pressure test.	86400000
DtsJobClass	string	No	La especificación de la tarea de migración de DTS. Puede llamar a la operación DescribeCloudbenchTask para obtener la especificación. Nota La tarea de prueba de estrés necesita migrar los datos de referencia de la instancia de origen a la instancia de destino. Este parámetro es obligatorio cuando crea una nueva tarea de DTS.	medium
DtsJobId	string	No	El ID de la tarea de migración de DTS. Puede llamar a la operación ConfigureDtsJob para obtener el ID. Nota Este parámetro es obligatorio cuando ya se ha creado una tarea de DTS en la consola de DTS.	23127
SrcSuperAccount	string	No	La cuenta con privilegios de la instancia de origen. Valor: admin. Nota Este parámetro es obligatorio cuando DstType se establece en Instance.	admin
SrcSuperPassword	string	No	La contraseña de la cuenta con privilegios de la instancia de origen. Nota Este parámetro es obligatorio cuando DstType se establece en Instance.	test123
DstSuperAccount	string	No	La cuenta con privilegios de la instancia de destino.	root
DstSuperPassword	string	No	La contraseña de la cuenta con privilegios de la instancia de destino.	test123
DstType	string	No	El tipo de la instancia de destino. Valores válidos: Instance (predeterminado): ID de la instancia. ConnectionString: dirección de conexión de la instancia.	Instance
DstConnectionString	string	No	La dirección de conexión de la instancia de destino. Solo se admiten instancias RDS MySQL y PolarDB MySQL. Nota Este parámetro surte efecto cuando DstType se establece en ConnectionString.	rm-de21209****.mysql.rds.aliyuncs.com
DstPort	string	No	El puerto de la instancia de destino. Nota Este parámetro surte efecto cuando DstType se establece en ConnectionString.	3306
WorkDir	string	No	El directorio temporal generado por la prueba de estrés.	/tmp/bench/
BackupId	string	No	El ID del conjunto de copias de seguridad. Puede llamar a la operación DescribeBackups para consultar la lista de copias de seguridad y obtener el ID.	229132
BackupTime	string	No	La hora de la copia de seguridad. Formato: yyyy-MM-ddTHH:mm:ssZ (hora UTC).	2021-04-23T13:22:14Z
Amount	string	No	El número total de tareas de prueba de estrés que se van a crear. Valores válidos: 0 a 30. Valor predeterminado: 1.	1
EndState	string	No	El estado después de que finaliza la tarea de prueba de estrés. Valores válidos: WAIT_TARGET: Preparar la instancia de destino para la prueba de estrés. WAIT_DBGATEWAY: Preparar el despliegue de la prueba de estrés. WAIT_SQL: Preparar las sentencias SQL completas. WAIT_LOGIC: Preparar el inicio de la reproducción del tráfico. Nota Cuando la tarea de prueba de estrés completa el estado establecido por EndState, la tarea alcanza directamente el estado de completada.	WAIT_TARGET

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
Code	string	El código de estado devuelto.	200
Message	string	El mensaje devuelto. Nota Cuando la solicitud es exitosa, se devuelve Successful. Cuando la solicitud falla, se devuelve información de excepción, como un código de error.	Successful
RequestId	string	El ID de la solicitud.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Success	string	Indica si la solicitud fue exitosa: true: La solicitud fue exitosa. false: La solicitud falló.	true
Data	object
taskIds	array	La lista de detalles.
	string	La lista de detalles, que incluye el número total de elementos de información, códigos de error y otra información.	"Data": { "total": 1, "list":[...] }, "Code": 200, "Success": true }

Ejemplos

Respuesta exitosa

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParams	The request parameters are invalid.
403	NoPermission	You are not authorized to do this action.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.