CreateSecurityGroup - - Centro de documentación de Alibaba Cloud

Cree un security group. De forma predeterminada, un security group solo permite que las instancias dentro del mismo se comuniquen entre sí. Las solicitudes de acceso desde fuera del security group se deniegan. Si desea permitir solicitudes desde Internet o desde instancias en otros security groups, llame a la operación AuthorizeSecurityGroup.

Descripción

Al llamar a esta operación, tenga en cuenta lo siguiente:

Puede crear hasta 100 security groups en una sola región de Alibaba Cloud.
Para crear un security group de tipo Virtual Private Cloud (VPC), especifique el parámetro VpcId.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	CreateSecurityGroup	La operación que desea ejecutar. Establezca el valor en CreateSecurityGroup.
RegionId	String	Sí	cn-hangzhou	El ID de región del security group. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
Description	String	No	testDescription	La descripción del security group. Debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con `http://` o `https://`. Este parámetro está vacío de forma predeterminada.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	El token de cliente que garantiza la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero asegúrese de que sea único entre diferentes solicitudes. El valor de ClientToken solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.
SecurityGroupName	String	No	testSecurityGroupName	El nombre del security group. Debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y no puede empezar con `http://` o `https://`. Puede contener letras, dígitos, dos puntos (:), guiones bajos (_) y guiones (-). Este parámetro está vacío de forma predeterminada.
VpcId	String	No	vpc-bp1opxu1zkhn00gzv****	El ID de la VPC donde se creará el security group. Nota Si la región especificada es compatible con la red clásica, puede crear security groups de tipo red clásica sin especificar el parámetro VpcId. Si la región especificada no admite la red clásica, especifique el parámetro VpcId para crear security groups de tipo VPC.
SecurityGroupType	String	No	enterprise	El tipo de security group. Valores válidos: normal: security group básico enterprise: security group avanzado. Para obtener más información, consulte Security groups avanzados.
ServiceManaged	Boolean	No	false	Este parámetro no está available.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	El ID del resource group al que pertenece el security group.
Tag.N.key	String	No	null	La clave de la etiqueta N del security group. Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar el parámetro Tag.N.Key para garantizar la compatibilidad futura.
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N del security group. Valores válidos de N: 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede contener `http://` o `https://`. Tampoco puede comenzar con `acs:` o `aliyun`.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N del security group. Valores válidos de N: 1 a 20. El valor de la etiqueta puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud y no puede comenzar con acs: ni contener `http://` o `https://`.
Tag.N.value	String	No	null	El valor de la etiqueta N del security group. Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar el parámetro Tag.N.Value para garantizar la compatibilidad futura.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
SecurityGroupId	String	sg-bp1fg655nh68xyz9****	El ID del security group.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

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

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

Formato JSON

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

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

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	Mensaje de error devuelto porque el parámetro Description especificado no es válido. La descripción debe tener entre 2 y 256 caracteres de longitud y no puede comenzar con http:// o https://.
400	InvalidSecurityGroupName.Malformed	Specified security group name is not valid.	Mensaje de error devuelto porque el parámetro SecurityGroupName especificado no es válido. El parámetro SecurityGroupName está vacío de forma predeterminada. Si se especifica este parámetro, el nombre indicado se muestra en la consola de Elastic Compute Service (ECS). El nombre debe tener entre 2 y 128 caracteres de longitud. Debe comenzar con una letra y puede contener letras, dígitos, puntos (.), guiones bajos (_) y guiones (-). El nombre no puede comenzar con http:// o https://.
400	InvalidSecurityGroupDiscription.Malformed	Specified security group description is not valid.	Mensaje de error devuelto porque la descripción del security group especificada no es válida.
400	IncorrectVpcStatus	Current VPC status does not support this operation.	Mensaje de error devuelto porque la operación no es compatible mientras la VPC se encuentra en el estado actual.
400	InvalidTagKey.Malformed	Specified tag key is not valid.	Mensaje de error devuelto porque la clave de etiqueta especificada no es válida.
400	InvalidTagValue.Malformed	Specified tag value is not valid.	Mensaje de error devuelto porque el valor de etiqueta especificado no es válido.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Mensaje de error devuelto porque la clave de etiqueta especificada ya existe. Las claves de etiqueta deben ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Mensaje de error devuelto porque el parámetro Tag.N.Key especificado no es válido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Mensaje de error devuelto porque el parámetro Tag.N.Value especificado no es válido.
400	InvalidParams.GroupType	The specified security group type is not valid.	Mensaje de error devuelto porque el tipo de security group especificado no es válido. Compruebe si el parámetro SecurityGroupType es válido.
400	InvalidParams.VpcIdGroupType	Only VPC instance supports enterprise level security group.	Mensaje de error devuelto porque solo las instancias ECS de tipo VPC admiten security groups avanzados.
500	InternalError	The request processing has failed due to some unknown error.	Mensaje de error devuelto porque se produjo un error interno. Inténtelo de nuevo más tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Mensaje de error devuelto porque se produjo un error interno. Inténtelo de nuevo más tarde.
403	QuotaExceed.SecurityGroup	The maximum number of security groups is reached.	Mensaje de error devuelto porque se alcanzó el número máximo de security groups. Envíe un ticket para solicitar un aumento de cuota.
403	InvalidVpcId.NotFound	vpc id must not empty when only support vpc vm.	Mensaje de error devuelto porque no se especificó el parámetro VpcId.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Mensaje de error devuelto porque se está procesando una solicitud idempotente anterior. Inténtelo de nuevo más tarde.
403	QuotaExceed.Tags	%s	Mensaje de error devuelto porque el número de etiquetas especificadas supera el límite superior. %s es una variable. Se devuelve un mensaje de error dinámicamente según las condiciones de la llamada.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Mensaje de error devuelto porque los security groups gestionados por servicios en la nube no se pueden modificar.
404	InvalidVpcId.NotFound	Specified VPC does not exist.	Mensaje de error devuelto porque el ID de VPC especificado no existe.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Mensaje de error devuelto porque el resource group especificado no existe.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.