CreateElasticPlan - AnalyticDB - Centre de documentation Alibaba Cloud

Crée un plan de mise à l'échelle pour un cluster AnalyticDB for MySQL.

Description de l'opération

Pour plus d'informations sur les points de terminaison d'AnalyticDB for MySQL, consultez Points de terminaison.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

adb:CreateElasticPlan

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ElasticPlanName	string	Oui	Le nom du plan de mise à l'échelle. Remarque Le nom doit comporter entre 2 et 30 caractères et peut contenir des lettres, des chiffres et des traits de soulignement (_). Le nom doit commencer par une lettre.	test
ResourceGroupName	string	Non	Le nom du groupe de ressources. Remarque Si vous souhaitez créer un plan de mise à l'échelle utilisant des groupes de ressources interactifs, vous devez spécifier ce paramètre. Si vous souhaitez créer un plan de mise à l'échelle utilisant des unités d'E/S élastiques (EIU), vous n'avez pas besoin de spécifier ce paramètre. Vous pouvez appeler l'opération DescribeDBResourceGroup pour interroger le nom du groupe de ressources d'un cluster.	test
StartTime	string	Non	L'heure de début du plan de mise à l'échelle. Remarque Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC.	2022-01-01T12:01:00Z
EndTime	string	Non	L'heure de fin du plan de mise à l'échelle. Remarque Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC.	2025-01-01T12:01:00Z
Enabled	boolean	Oui	Indique si le plan de mise à l'échelle doit être activé immédiatement après sa création. Valeurs valides : true false	true
CronExpression	string	Non	Une expression CRON qui spécifie le cycle et l'heure de mise à l'échelle pour le plan de mise à l'échelle.	0 20 14 * * ?
TargetSize	string	Non	Les spécifications souhaitées des ressources élastiques après la mise à l'échelle. Remarque Si le plan de mise à l'échelle utilise des EIU et que la Mise à l'échelle proportionnelle par défaut pour les EIU est activée, vous n'avez pas besoin de spécifier ce paramètre. Dans les autres cas, vous devez spécifier ce paramètre. Vous pouvez appeler l'opération DescribeElasticPlanSpecifications pour interroger les spécifications prises en charge pour les plans de mise à l'échelle.	32ACU
Type	string	Oui	Le type du plan de mise à l'échelle. Valeurs valides : EXECUTOR : le type de groupe de ressources interactif, qui indique le type de ressource de calcul. WORKER : le type EIU.	EXECUTOR
AutoScale	boolean	Non	Indique si la Mise à l'échelle proportionnelle par défaut pour les EIU doit être activée. Valeurs valides : true. Dans ce cas, les ressources de stockage sont mises à l'échelle en même temps que les ressources de calcul, et les paramètres TargetSize et CronExpression ne sont pas pris en charge. false Remarque Ce paramètre doit être spécifié lorsque Type est défini sur WORKER. Ce paramètre n'est pas requis lorsque Type est défini sur EXECUTOR. Vous ne pouvez activer la mise à l'échelle proportionnelle par défaut pour les EIU que pour un seul plan de mise à l'échelle d'un cluster.	false
DBClusterId	string	Oui	L'identifiant du cluster. Remarque Vous pouvez appeler l'opération DescribeDBClusters pour interroger les identifiants de tous les clusters AnalyticDB for MySQL au sein d'une région.	amv-wz9509beptiz****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	A5C433C2-001F-58E3-99F5-3274C14DF8BD

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
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.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.