RunCluster - - Centre de documentation Alibaba Cloud

Crée un cluster à la demande ou par abonnement.

Description de l'opération

RunCluster est une version améliorée de CreateCluster. Elle utilise des requêtes POST HTTPS et prend en charge des valeurs de paramètres plus importantes. Pour les paramètres complexes, tels que les objets et les tableaux, RunCluster utilise le format JSON. Cela améliore la compatibilité avec les outils d'interface de ligne de commande (CLI).

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.

emr:RunCluster

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région.	cn-hangzhou
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-acfmzabjyop****
PaymentType	string	Non	La méthode de facturation. Valeurs valides : PayAsYouGo : à la demande. Subscription : abonnement. Valeur par défaut : PayAsYouGo.	PayAsYouGo
SubscriptionConfig	SubscriptionConfig	Non	Les configurations d'abonnement. Ce paramètre est requis si vous définissez PaymentType sur Subscription.
ClusterType	string	Oui	Le type de cluster. Valeurs valides : DATALAKE : nouveau lac de données. OLAP : analyse de données. DATAFLOW : flux de données en temps réel. DATASERVING : DataService Studio. CUSTOM : cluster personnalisé. HADOOP : lac de données hérité. Cette valeur n'est pas recommandée. Utilisez plutôt le nouveau type de cluster de lac de données. Si vous créez un cluster EMR pour la première fois après 17:00 (UTC+8) le 19 décembre 2022, vous ne pouvez pas sélectionner HADOOP, DATA_SCIENCE, PRESTO ou ZOOKEEPER comme type de cluster.	DATALAKE
ReleaseVersion	string	Oui	La version de publication d'EMR. Vous pouvez trouver la version de publication d'EMR sur la page d'achat du cluster EMR.	EMR-5.16.0
ClusterName	string	Oui	Le nom du cluster. Le nom doit comporter entre 1 et 128 caractères. Il doit commencer par une lettre ou un caractère chinois. Il ne peut pas commencer par http:// ou https://. Il peut contenir des caractères chinois, des lettres, des chiffres, des deux-points (:), des traits de soulignement (_), des points (.) ou des traits d'union (-).	emrtest
DeployMode	string	Non	Le mode de déploiement des applications dans le cluster. Valeurs valides : NORMAL (par défaut) : déploiement sans haute disponibilité. Le cluster dispose d'un nœud maître. HA : déploiement à haute disponibilité (HA). Ce mode de déploiement nécessite au moins trois nœuds maîtres.	HA
SecurityMode	string	Non	Le mode de sécurité Kerberos du cluster. Valeurs valides : NORMAL (par défaut) : mode normal. Kerberos est désactivé. KERBEROS : mode Kerberos. Kerberos est activé.	NORMAL
Applications	array	Oui	La liste des applications. Le nombre d'éléments de tableau N peut varier de 1 à 100.
	Application	Non	L'application.
ApplicationConfigs	array	Non	Les configurations d'application. Le nombre d'éléments de tableau N peut varier de 1 à 1 000.
	ApplicationConfig	Non	La configuration de l'application.
NodeAttributes	NodeAttributes	Non	Les attributs de nœud. Il s'agit des attributs de base de tous les nœuds ECS du cluster.
NodeGroups	array	Oui	Le tableau des configurations de groupe de nœuds. Le nombre d'éléments de tableau N peut varier de 1 à 100.
	NodeGroupConfig	Non	La configuration du groupe de nœuds.
BootstrapScripts	array	Non	Le tableau des scripts d'amorçage. Le nombre d'éléments de tableau N peut varier de 1 à 10.
	Script	Non	Le script d'amorçage.
Tags	array	Non	Les balises. Le nombre d'éléments de tableau N peut varier de 0 à 20.
	Tag	Non	La balise.
ClientToken	string	Non	Un jeton client pour garantir l'idempotence de la requête. Plusieurs appels avec le même jeton client renvoient le même résultat et ne créent qu'un seul cluster.	A7D960FA-6DBA-5E07-8746-A63E3E4D****
Description	string	Non	La description du cluster.	Cluster EMR pour ETL
DeletionProtection	boolean	Non	Indique si la protection contre la suppression doit être activée pour le cluster. Valeurs valides : true : active la protection contre la suppression. false : désactive la protection contre la suppression. Valeur par défaut : false.	false
Promotions	array	Non
	Promotion	Non

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
ClusterId	string	L'identifiant du cluster.	c-b933c5aac7f7***
OperationId	string	L'identifiant de l'opération.	op-13c37a77c505****
RequestId	string	L'identifiant de la requête.	DD6B1B2A-5837-5237-ABE4-FF0C8944****

Exemples

JSON format

{
  "ClusterId": "c-b933c5aac7f7***",
  "OperationId": "op-13c37a77c505****",
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	OperationDenied	The operation is invalid. %s
400	OutOfStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.
400	QuotaExceeded	Request fail due to quota exceed. %s
400	AccountException	Account exception. %s
400	ConflictParameters	Parameters that must not be used together. %s
400	IncompleteSignature	The request signature is invalid.
400	InvalidAction	The action %s requested is invalid.
400	InvalidParameter	The specified parameter %s is not valid.
400	InvalidParameterValue	The input parameter %s is invalid or out of range.
400	MissingAction	The action %s requested is missing.
400	MissingParameter	The input parameter %s that is mandatory for processing this request is not supplied.
400	NotAuthorized	You do not have permission to perform this action. %s
400	ThrottlingException	The request was denied due to request throttling. %s
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
404	ResourceNotFound	The resource not found by %s.
503	ServiceFailure	The request has failed due to a temporary failure of %s service.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.

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

Notes de version

Consultez Notes de version pour la liste complète.