CreateCluster - - Centre de documentation Alibaba Cloud

Crée un cluster facturé à l'usage ou par abonnement.

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

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 : facturé à l'usage. 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 : service de données. CUSTOM : cluster personnalisé. HADOOP : lac de données de version antérieure. Nous vous recommandons d'utiliser le nouveau lac de données. Si vous créez un cluster EMR pour la première fois après 17h00 (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 les versions de publication d'EMR sur la page d'achat des clusters EMR.	EMR-5.16.0
ClusterName	string	Oui	Le nom du cluster. Le nom doit comporter de 1 à 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 lettres, des chiffres, des caractères chinois, des deux-points (:), des traits de soulignement (_), des points (.) et 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é (HA). Le cluster dispose d'un nœud maître. HA : déploiement HA. Un déploiement HA 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 doit être compris entre 1 et 100.
	Application	Non	L'application.
ApplicationConfigs	array	Non	Les configurations d'application. Le nombre d'éléments de tableau N doit être compris entre 1 et 1 000.
	ApplicationConfig	Non	La configuration de l'application.
NodeAttributes	NodeAttributes	Oui	Les attributs de nœud. Ce paramètre spécifie les attributs de base de tous les nœuds Elastic Compute Service (ECS) du cluster.
NodeGroups	array	Oui	Le tableau des configurations de groupe de nœuds. Le nombre d'éléments de tableau N doit être compris entre 1 et 100.	NORMAL
	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 doit être compris entre 1 et 10.
	Script	Non	Le script d'amorçage.
Tags	array	Non	Les balises. Le nombre d'éléments de tableau N doit être compris entre 0 et 20.	A7D960FA-6DBA-5E07-8746-A63E3E4D****
	Tag	Non	La balise.
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Les résultats de plusieurs appels utilisant le même jeton client sont identiques. Un maximum d'un cluster peut être créé avec le même jeton client.	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

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les données renvoyées.
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.