CreateActivation - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Après avoir enregistré un serveur non fourni par Alibaba Cloud en tant qu'instance gérée Alibaba Cloud à l'aide d'un code d'activation, vous pouvez exploiter divers services en ligne d'Alibaba Cloud sur cette instance, tels que Cloud Assistant, CloudOps Orchestration Service (OOS) et Apsara Devops.

Pour enregistrer un serveur non fourni par Alibaba Cloud en tant qu'instance gérée Alibaba Cloud, celui-ci doit disposer d'une connectivité Internet et exécuter l'un des systèmes d'exploitation suivants :

Alibaba Cloud Linux 2, Alibaba Cloud Linux 3 et versions ultérieures
CentOS 6, CentOS 7, CentOS 8 et versions ultérieures
Debian 8, Debian 9, Debian 10 et versions ultérieures
Ubuntu 12, Ubuntu 14, Ubuntu 16, Ubuntu 18 et versions ultérieures
CoreOS
OpenSUSE
Red Hat 5, Red Hat 6, Red Hat 7 et versions ultérieures
SUSE Linux Enterprise Server (SLES) 11, SLES 12, SLES 15 et versions ultérieures
Windows Server 2012, Windows Server 2016, Windows Server 2019 et versions ultérieures

Vous pouvez créer jusqu'à 5 000 codes d'activation par région Alibaba Cloud. Lorsque le nombre de codes d'activation dépasse 1 000, leur taux d'utilisation doit être supérieur à 50 % avant que vous ne puissiez en créer de nouveaux.

Remarque

Pour consulter le taux d'utilisation des codes d'activation, accédez à la page

Cloud Assistant

de la console Elastic Compute Service (ECS), cliquez sur l'onglet

Manage Instances

, puis cliquez sur

Register Instance

.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateActivation	Opération à effectuer. Définissez la valeur sur CreateActivation.
RegionId	String	Yes	cn-hangzhou	ID de région du code d'activation. Régions prises en charge : Chine (Qingdao), Chine (Pékin), Chine (Zhangjiakou), Chine (Hohhot), Chine (Ulanqab), Chine (Hangzhou), Chine (Shanghai), Chine (Shenzhen), Chine (Heyuan), Chine (Guangzhou), Chine (Chengdu), Chine (Hong Kong), Singapour, Japon (Tokyo), États-Unis (Silicon Valley) et États-Unis (Virginie). Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
InstanceName	String	No	test-InstanceName	Préfixe par défaut du nom de l'instance. Le préfixe doit comporter entre 2 et 50 caractères. Il doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`. Il peut contenir des lettres, des chiffres, des points (.), des traits de soulignement (_), des traits d'union (-) et deux-points (:). Si vous utilisez le code d'activation créé via l'opération CreateActivation pour enregistrer des instances gérées, ces dernières reçoivent des noms séquentiels incluant la valeur de ce paramètre comme préfixe. Vous pouvez également spécifier un nouveau nom d'instance pour remplacer le nom séquentiel attribué lors de l'enregistrement d'une instance gérée. Si vous spécifiez InstanceName lors de l'enregistrement d'une instance gérée, un nom d'instance au format `<InstanceName>-<Number>` est généré. Le nombre de chiffres dans la valeur <Number> varie en fonction du nombre de chiffres dans la valeur `InstanceCount`. Exemple : `001`. Si vous ne spécifiez pas InstanceName, le nom d'hôte (Hostname) est utilisé comme nom d'instance.
Description	String	No	This is description.	Description du code d'activation. Elle doit comporter entre 1 et 100 caractères.
InstanceCount	Integer	No	10	Nombre maximal d'utilisations du code d'activation pour enregistrer des instances gérées. Valeurs possibles : 1 à 1000. Valeur par défaut : 10.
TimeToLiveInHours	Long	No	4	Période de validité du code d'activation. Le code d'activation ne peut plus être utilisé pour enregistrer des instances une fois cette période écoulée. Unité : heures. Valeurs possibles : 1 à 876576. Cela représente une plage allant de 1 heure à 100 ans. Valeur par défaut : 4.
IpAddressRange	String	No	0.0.0.0/0	Adresses IP des hôtes autorisés à utiliser le code d'activation. La valeur peut être des adresses IPv4, des adresses IPv6 ou des blocs CIDR.
ResourceGroupId	String	No	rg-123******	ID du groupe de ressources auquel appartient le code d'activation.
Tag.N.Key	String	No	TestKey	Clé du tag N à ajouter au code d'activation. Valeurs possibles pour N : 1 à 20. La clé du tag ne peut pas être une chaîne vide. Si vous spécifiez un seul tag pour interroger des ressources, jusqu'à 1 000 ressources auxquelles ce tag est ajouté peuvent être renvoyées. Si vous spécifiez plusieurs tags pour interroger des ressources, jusqu'à 1 000 ressources auxquelles tous ces tags sont ajoutés peuvent être renvoyées. Pour interroger plus de 1 000 ressources possédant les tags spécifiés, appelez l'opération ListTagResources. La clé du tag peut comporter jusqu'à 64 caractères et ne peut pas contenir `http://` ou `https://`. La clé du tag ne peut pas commencer par `acs:` ou `aliyun`.
Tag.N.Value	String	No	TestValue	Valeur du tag N à ajouter au code d'activation. Valeurs possibles pour N : 1 à 20. La valeur du tag peut être une chaîne vide. La valeur du tag peut comporter jusqu'à 128 caractères et ne peut pas contenir `http://` ou `https://`.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	4ECEEE12-56F1-4FBC-9AB1-890F1234****	ID de la requête.
ActivationCode	String	a-hz0ch3SwhOlE1234+Xo32lAZC****	Valeur du code d'activation. Cette valeur n'est renvoyée qu'une seule fois après l'appel de l'opération CreateActivation. Conservez correctement la valeur renvoyée.
ActivationId	String	4ECEEE12-56F1-4FBC-9AB1-890F1234****	ID du code d'activation.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=CreateActivation
&InstanceName=test-InstanceName
&RegionId=cn-hangzhou
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateActivationResponse>
    <RequestId>4ECEEE12-56F1-4FBC-9AB1-890F1234****</RequestId>
    <ActivationId>4ECEEE12-56F1-4FBC-9AB1-890F1234****</ActivationId>
    <ActivationCode>a-hz0ch3SwhOlE1234+Xo32lAZC****</ActivationCode>
</CreateActivationResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4ECEEE12-56F1-4FBC-9AB1-890F1234****",
  "ActivationId" : "4ECEEE12-56F1-4FBC-9AB1-890F1234****",
  "ActivationCode" : "a-hz0ch3SwhOlE1234+Xo32lAZC****"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	RegionId.ApiNotSupported	The api is not supported in this region.	L'opération ne peut pas être appelée dans la région spécifiée. Vérifiez si l'ID de région est valide.
400	InstanceName.ExceedLimit	Default instance name prefix length exceeds.	La longueur maximale du préfixe du nom de l'instance est dépassée.
400	InstanceName.InvalidPattern	Default instance name prefix pattern invalid.	Valeur InstanceName non valide.
400	ActivationDesc.ExceedLimit	Activation description length exceeds.	La longueur maximale de la description du code d'activation est dépassée.
400	ActivationLimitation.Invalid	Registration limitation must be positive.	Le nombre maximal d'utilisations du code d'activation pour enregistrer des instances gérées est dépassé.
400	AddressRange.InvalidPattern	Address range should be ipv4 address or cidr.	Les adresses IP des hôtes autorisés à utiliser le code d'activation doivent être des adresses IPv4, des adresses IPv6 ou des blocs CIDR.
400	ActivationCount.ExceedLimit	Too many activations have been created.	Le nombre maximal de codes d'activation pouvant être créés est dépassé.
400	ActivationTTL.ExceedLimit	Activation TTL exceeds limit.	Valeur TimeToLiveInHours non valide.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valeur Tag.N.Key non valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valeur Tag.N.Value non valide.
400	NumberExceed.Tags	The Tags parameter number is exceed.	Le nombre maximal de tags est dépassé.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tag.N.Key est requis.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	La clé de tag existe déjà. Les clés de tag doivent être uniques.
403	Operation.Forbidden	The operation is not permitted.	L'opération n'est pas prise en charge.
403	InvalidStatus.ResourceGroup	You cannot perform an operation on a resource group that is being created or deleted.	Vous ne pouvez pas effectuer cette opération sur un groupe de ressources en cours de création ou de suppression.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Le groupe de ressources est introuvable.
500	InternalError.Dispatch	An error occurred when dispatch the request.	Une erreur s'est produite lors de l'envoi de la requête. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.