CreateElasticPlan - - Centro de documentación de Alibaba Cloud

Crea un plan de escalado para un clúster de AnalyticDB for MySQL.

Descripción de la operación

Para obtener información sobre los endpoints de AnalyticDB for MySQL, consulte Endpoints.

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

adb:CreateElasticPlan

create

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ElasticPlanName	string	Sí	El nombre del plan de escalado. Nota El nombre debe tener entre 2 y 30 caracteres de longitud y puede contener letras, dígitos y guiones bajos (_). El nombre debe comenzar con una letra.	test
ResourceGroupName	string	No	El nombre del grupo de recursos. Nota Si desea crear un plan de escalado que utilice grupos de recursos interactivos, debe especificar este parámetro. Si desea crear un plan de escalado que utilice unidades de E/S elásticas (EIU), no necesita especificar este parámetro. Puede llamar a la operación DescribeDBResourceGroup para consultar el nombre del grupo de recursos de un clúster.	test
StartTime	string	No	La hora de inicio del plan de escalado. Nota Especifique la hora en formato ISO 8601: yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC.	2022-01-01T12:01:00Z
EndTime	string	No	La hora de finalización del plan de escalado. Nota Especifique la hora en formato ISO 8601: yyyy-MM-ddTHH:mm:ssZ. La hora debe estar en UTC.	2025-01-01T12:01:00Z
Enabled	boolean	Sí	Especifica si se debe habilitar inmediatamente el plan de escalado después de su creación. Valores válidos: true false	true
CronExpression	string	No	Una expresión CRON que especifica el ciclo de escalado y la hora para el plan de escalado.	0 20 14 * * ?
TargetSize	string	No	Las especificaciones deseadas de los recursos elásticos después del escalado. Nota Si el plan de escalado utiliza EIU y la opción Escalado proporcional predeterminado para EIU está habilitada, no necesita especificar este parámetro. En otros casos, debe especificar este parámetro. Puede llamar a la operación DescribeElasticPlanSpecifications para consultar las especificaciones admitidas para los planes de escalado.	32ACU
Type	string	Sí	El tipo del plan de escalado. Valores válidos: EXECUTOR: el tipo de grupo de recursos interactivo, que indica el tipo de recurso de computación. WORKER: el tipo EIU.	EXECUTOR
AutoScale	boolean	No	Especifica si se debe habilitar el Escalado proporcional predeterminado para EIU. Valores válidos: true. En este caso, los recursos de almacenamiento se escalan junto con los recursos de computación, y los parámetros TargetSize y CronExpression no son compatibles. false Nota Este parámetro debe especificarse cuando Type se establece en WORKER. Este parámetro no es necesario cuando Type se establece en EXECUTOR. Solo puede habilitar el Escalado proporcional predeterminado para EIU para un único plan de escalado por clúster.	false
DBClusterId	string	Sí	El ID del clúster. Nota Puede llamar a la operación DescribeDBClusters para consultar los ID de todos los clústeres de AnalyticDB for MySQL dentro de una región.	amv-wz9509beptiz****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	A5C433C2-001F-58E3-99F5-3274C14DF8BD

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "A5C433C2-001F-58E3-99F5-3274C14DF8BD"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	ACS.ElasticPlan.InvalidEndTime	The end time should be later than current time.	The end time of scheduled scaling must be later than the current time.
400	ACS.ElasticPlan.NameAlreadyExists	The name already exists.	A scaling plan with the same name exists.
400	ACS.ElasticPlan.WorkerNotFound	Worker not found.	The cluster cannot have storage scaling plans configured because it does not have reserved storage resources.
400	ACS.ElasticPlan.AutoWorkerPlanExists	Failed to enable the elastic plan. The instance already has an active elastic plan.	Failed to enable the storage scaling plan because the cluster has another storage scaling plan enabled.
400	ACS.ElasticPlan.WorkerPlanExists	Failed to enable the elastic plan. At least one active elastic plan already exists.	Failed to enable the storage scaling plan because another storage scaling plan has been enabled.
400	ACS.ElasticPlan.InvalidStartTimeInterval	The start time of this elastic plan is too closed to another one.	The effective time of the scaling plan is close to that of another scaling plan.
400	ACS.ElasticPlan.InvalidTodayPlan	Failed to enable this elastic plan. Today's schedule time is missed and you should prepare at least %s minutes for us to prepare resource.	Failed to enable the elastic plan. The elastic scaling operation cannot be triggered at the configured time today. Make sure that the configured time is later than the earliest available time (current time plus %s minutes for resource preparation).
400	ACS.ElasticPlan.InvalidTargetSize	Invalid target size.	The target specification is invalid.
400	ACS.ElasticPlan.InvalidStartTime	Invalid start time.	The start time of the elastic plan is invalid.
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	The specified DBClusterId parameter does not exist. Make sure that the DBClusterId value is valid.

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.