CreateSecurityGroup - - Centre de documentation Alibaba Cloud

Description

Lors de l'appel à cette opération, tenez compte des points suivants :

Vous pouvez créer jusqu'à 100 groupes de sécurité dans une même région Alibaba Cloud.
Pour créer un groupe de sécurité de type Virtual Private Cloud (VPC), spécifiez le paramètre VpcId.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateSecurityGroup	Opération à effectuer. Définissez la valeur sur CreateSecurityGroup.
RegionId	String	Yes	cn-hangzhou	ID de région du groupe de sécurité. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
Description	String	No	testDescription	Description du groupe de sécurité. La longueur doit être comprise entre 2 et 256 caractères. Elle ne peut pas commencer par `http://` ou `https://`. Ce paramètre est vide par défaut.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Jeton client utilisé pour garantir l'idempotence de la requête. Générez la valeur via le client, en veillant à son unicité pour chaque requête. La valeur ClientToken ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez la rubrique Comment garantir l'idempotence.
SecurityGroupName	String	No	testSecurityGroupName	Nom du groupe de sécurité. La longueur doit être comprise entre 2 et 128 caractères. Le nom doit commencer par une lettre et ne peut pas commencer par `http://` ou `https://`. Il peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-). Ce paramètre est vide par défaut.
VpcId	String	No	vpc-bp1opxu1zkhn00gzv****	ID du VPC dans lequel créer le groupe de sécurité. Remarque Si la région spécifiée prend en charge le réseau classique, vous pouvez créer des groupes de sécurité de type réseau classique sans spécifier le paramètre VpcId. Si la région spécifiée ne prend pas en charge le réseau classique, spécifiez le paramètre VpcId pour créer des groupes de sécurité de type VPC.
SecurityGroupType	String	No	enterprise	Type du groupe de sécurité. Valeurs possibles : normal : groupe de sécurité basique enterprise : groupe de sécurité avancé Pour plus d'informations, consultez la rubrique Groupes de sécurité avancés.
ServiceManaged	Boolean	No	false	Ce paramètre n'est pas disponible.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	ID du groupe de ressources auquel appartient le groupe de sécurité.
Tag.N.key	String	No	null	Clé du tag N du groupe de sécurité. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser le paramètre Tag.N.Key pour garantir la compatibilité future.
Tag.N.Key	String	No	TestKey	Clé du tag N du groupe de sécurité. Valeurs possibles de N : 1 à 20. La clé de tag ne peut pas être une chaîne vide. Sa longueur maximale est de 128 caractères. Elle ne peut pas contenir `http://` ou `https://`. Elle ne peut pas commencer par `acs:` ou `aliyun`.
Tag.N.Value	String	No	TestValue	Valeur du tag N du groupe de sécurité. Valeurs possibles de N : 1 à 20. La valeur de tag peut être une chaîne vide. Sa longueur maximale est de 128 caractères. Elle ne peut pas commencer par acs: ni contenir `http://` ou `https://`.
Tag.N.value	String	No	null	Valeur du tag N du groupe de sécurité. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser le paramètre Tag.N.Value pour garantir la compatibilité future.

Paramètres de réponse

Parameter	Type	Example	Description
SecurityGroupId	String	sg-bp1fg655nh68xyz9****	ID du groupe de sécurité.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=CreateSecurityGroup
&RegionId=cn-hangzhou
&Description=testDescription
&VpcId=vpc-bp1opxu1zkhn00gzv****
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<CreateSecurityGroupResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    <SecurityGroupId>sg-bp1fg655nh68xyz9****</SecurityGroupId>
</CreateSecurityGroupResponse>

JSON format

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

{
  "RequestId" : "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "SecurityGroupId" : "sg-bp1fg655nh68xyz9****"
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	Message d'erreur indiquant que le paramètre Description spécifié n'est pas valide. La description doit comporter entre 2 et 256 caractères et ne peut pas commencer par http:// ou https://.
400	InvalidSecurityGroupName.Malformed	Specified security group name is not valid.	Message d'erreur indiquant que le paramètre SecurityGroupName spécifié n'est pas valide. Le paramètre SecurityGroupName est vide par défaut. Si ce paramètre est spécifié, le nom indiqué s'affiche dans la console Elastic Compute Service (ECS). La longueur doit être comprise entre 2 et 128 caractères. Le nom doit commencer par une lettre et peut contenir des lettres, des chiffres, des points (.), des traits de soulignement (_) et des traits d'union (-). Le nom ne peut pas commencer par http:// ou https://.
400	InvalidSecurityGroupDiscription.Malformed	Specified security group description is not valid.	Message d'erreur indiquant que la description du groupe de sécurité spécifiée n'est pas valide.
400	IncorrectVpcStatus	Current VPC status does not support this operation.	Message d'erreur indiquant que l'opération n'est pas prise en charge lorsque le VPC se trouve dans l'état actuel.
400	InvalidTagKey.Malformed	Specified tag key is not valid.	Message d'erreur indiquant que la clé de tag spécifiée n'est pas valide.
400	InvalidTagValue.Malformed	Specified tag value is not valid.	Message d'erreur indiquant que la valeur de tag spécifiée n'est pas valide.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Message d'erreur indiquant que la clé de tag spécifiée existe déjà. Les clés de tag doivent être uniques.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Message d'erreur indiquant que le paramètre Tag.N.Key spécifié n'est pas valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Message d'erreur indiquant que le paramètre Tag.N.Value spécifié n'est pas valide.
400	InvalidParams.GroupType	The specified security group type is not valid.	Message d'erreur indiquant que le type de groupe de sécurité spécifié n'est pas valide. Vérifiez si le paramètre SecurityGroupType est valide.
400	InvalidParams.VpcIdGroupType	Only VPC instance supports enterprise level security group.	Message d'erreur indiquant que seules les instances ECS de type VPC prennent en charge les groupes de sécurité avancés.
500	InternalError	The request processing has failed due to some unknown error.	Message d'erreur indiquant qu'une erreur interne s'est produite. Réessayez ultérieurement.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Message d'erreur indiquant qu'une erreur interne s'est produite. Réessayez ultérieurement.
403	QuotaExceed.SecurityGroup	The maximum number of security groups is reached.	Message d'erreur indiquant que le nombre maximal de groupes de sécurité a été atteint. Soumettez un ticket pour demander une augmentation du quota.
403	InvalidVpcId.NotFound	vpc id must not empty when only support vpc vm.	Message d'erreur indiquant que le paramètre VpcId n'est pas spécifié.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Message d'erreur indiquant qu'une requête idempotente précédente est toujours en cours de traitement. Réessayez ultérieurement.
403	QuotaExceed.Tags	%s	Message d'erreur indiquant que le nombre de tags spécifiés dépasse la limite supérieure. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Message d'erreur indiquant que les groupes de sécurité gérés par les services cloud ne peuvent pas être modifiés.
404	InvalidVpcId.NotFound	Specified VPC does not exist.	Message d'erreur indiquant que l'ID de VPC spécifié n'existe pas.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Message d'erreur indiquant que le groupe de ressources spécifié n'existe pas.

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