AuthorizeSecurityGroup - - Centro de documentación de Alibaba Cloud

Crea una o más reglas de entrada en un security group. Las reglas creadas permiten autorizar o denegar el tráfico de entrada desde otros hosts hacia las instancias del security group.

Descripción

Al llamar a esta operación, tenga en cuenta los siguientes puntos:

El número total de reglas de salida y de entrada en cada security group no puede exceder 200. Para obtener más información, consulte la sección "Límites de security groups" en Límites.
El valor válido de Priority oscila entre 1 y 100. Un valor menor indica una prioridad mayor.
Cuando varias reglas de security group tienen la misma prioridad, las reglas de denegación (drop) tienen precedencia.
El origen puede ser un bloque CIDR especificado mediante SourceCidrIp, Ipv6SourceCidrIp o SourcePrefixListId, o bien instancias de Elastic Compute Service (ECS) en un security group especificado mediante SourceGroupId.
No se pueden usar security groups como objetos de autorización (destinos u orígenes) en las reglas de security groups avanzados.
Se pueden referenciar hasta 20 security groups como objetos de autorización en las reglas de cada security group básico.
Si la regla de security group especificada ya existe, la llamada a AuthorizeSecurityGroup se ejecuta correctamente, pero no se crea ninguna regla nueva.
Los parámetros y sus equivalentes con el prefijo Permissions.N no se pueden especificar al mismo tiempo. Se recomienda usar los parámetros con el prefijo Permissions.N.
Para definir una regla de security group, debe especificar uno de los siguientes conjuntos de parámetros. No es posible definir una regla si solo especifica un parámetro.
- Parámetros para definir una regla de entrada que controla el acceso desde un bloque CIDR específico: IpProtocol, PortRange, SourcePortRange (opcional), NicType, Policy y SourceCidrIp. Para un security group de tipo Virtual Private Cloud (VPC), establezca el parámetro NicType en intranet. Para un security group de red clásica, puede establecer NicType en internet o intranet. Ejemplo de solicitud:
```
        http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
        &SecurityGroupId=sg-bp67acfmxazb4p****
        &Permissions.1.SourceCidrIp=10.0.0.0/8
        &Permissions.1.IpProtocol=TCP
        &Permissions.1.PortRange=22/22
        &Permissions.1.NicType=intranet
        &Permissions.1.Policy=Accept
        &<Common request parameters>
        
```
- Parámetros para definir una regla de entrada que controla el acceso desde otro security group: IpProtocol, PortRange, SourcePortRange (opcional), NicType, Policy, SourceGroupOwnerAccount y SourceGroupId. En este caso, establezca el parámetro NicType en intranet. Para el acceso mutuo entre security groups en la red clásica, puede permitir o denegar el acceso de otro security group dentro de la misma región a su security group. El security group al que se le permite el acceso puede pertenecer a su propia cuenta de Alibaba Cloud o a otra cuenta especificada mediante el parámetro SourceGroupOwnerAccount. Para el acceso mutuo entre security groups en VPC, puede permitir o denegar el acceso de otro security group dentro de la misma VPC. Ejemplo de solicitud:
```
        http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
        &SecurityGroupId=sg-bp67acfmxazb4p****
        &Permissions.1.SourceGroupId=sg-1651FBB**
        &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
        &Permissions.1.IpProtocol=TCP
        &Permissions.1.PortRange=22/22
        &Permissions.1.NicType=intranet
        &Permissions.1.Policy=Drop
        &<Common request parameters>
        
```
- Parámetros para definir una regla de entrada que controla el acceso desde una lista de prefijos: IpProtocol, PortRange, SourcePortRange (opcional), NicType, Policy y SourcePrefixListId. En este caso, las listas de prefijos solo son compatibles con security groups en VPC. Establezca el parámetro NicType en intranet. Ejemplo de solicitud:
```
        http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
        &SecurityGroupId=sg-bp67acfmxazb4p****
        &Permissions.1.SourcePrefixListId=pl-x1j1k5ykzqlixdcy****
        &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
        &Permissions.1.IpProtocol=TCP
        &Permissions.1.PortRange=22/22
        &Permissions.1.NicType=intranet
        &Permissions.1.Policy=Drop
        &<Common request parameters>
       
```
Para consultar ejemplos sobre la configuración de reglas de security group, consulte Security groups para diferentes casos de uso y Reglas de quintupla de security group.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda realizar esta llamada directamente desde OpenAPI Explorer. Esta herramienta 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í	AuthorizeSecurityGroup	La operación que desea ejecutar. Establezca el valor en AuthorizeSecurityGroup.
RegionId	String	Sí	cn-hangzhou	El ID de región del security group. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	El token de cliente que se usa para garantizar la idempotencia de la solicitud. Puede generar este valor desde el cliente, pero debe asegurarse de que sea único para cada solicitud distinta. El valor de ClientToken solo puede contener caracteres ASCII y no debe superar los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.
SecurityGroupId	String	Sí	sg-bp67acfmxazb4p****	El ID del security group.
Permissions.N.Policy	String	No	accept	La acción de la regla N del security group que determina si se permite el acceso de entrada. Valores válidos: accept: permite el acceso. drop: deniega el acceso sin devolver respuesta. En este caso, la solicitud agota el tiempo de espera o no se puede establecer la conexión. Valor predeterminado: accept. Valores válidos de N: 1 a 100.
Permissions.N.Priority	String	No	1	La prioridad de la regla N del security group. Un valor menor indica una prioridad mayor. Valores válidos: 1 a 100. Valor predeterminado: 1. Valores válidos de N: 1 a 100.
Permissions.N.IpProtocol	String	No	ALL	El protocolo de capa de transporte de la regla N del security group. El valor de este parámetro no distingue entre mayúsculas y minúsculas. Valores válidos: TCP UDP ICMP ICMPv6 GRE ALL: se admiten todos los protocolos. Valores válidos de N: 1 a 100.
Permissions.N.SourceCidrIp	String	No	10.0.0.0/8	El bloque CIDR IPv4 de origen para la regla N del security group. Se admiten bloques CIDR y direcciones IPv4. Valores válidos de N: 1 a 100.
Permissions.N.Ipv6SourceCidrIp	String	No	2001:250:6000::***	El bloque CIDR IPv6 de origen para la regla N del security group. Se admiten bloques CIDR y direcciones IPv6. Valores válidos de N: 1 a 100. Nota El parámetro Permissions.N.Ipv6SourceCidrIp solo es válido cuando el origen son instancias de ECS residentes en VPC que admiten bloques CIDR IPv6. No puede especificar este parámetro y el parámetro `SourceCidrIp` simultáneamente.
Permissions.N.SourceGroupId	String	No	sg-bp67acfmxazb4p****	El ID del security group de origen que se referencia en la regla N del security group. Debe especificar como mínimo uno de los siguientes parámetros: `SourceGroupId`, `SourceCidrIp`, `Ipv6SourceCidrIp` o `SourcePrefixListId`. Si se especifica `SourceGroupId` pero no se especifica `SourceCidrIp` ni `Ipv6SourceCidrIp`, `NicType` debe establecerse en `intranet`. Si se especifican tanto `SourceGroupId` como `SourceCidrIp`, `SourceCidrIp` tiene prioridad. Valores válidos de N: 1 a 100. Tenga en cuenta los siguientes puntos: No se pueden usar security groups como destinos u orígenes en las reglas de security groups avanzados. Se pueden referenciar hasta 20 security groups como destinos u orígenes en las reglas de cada security group básico.
Permissions.N.SourcePrefixListId	String	No	pl-x1j1k5ykzqlixdcy****	El ID de la lista de prefijos de origen que se referencia en la regla N del security group. Puede llamar a la operación DescribePrefixLists para consultar los ID de las listas de prefijos disponibles. Valores válidos de N: 1 a 100. Tenga en cuenta los siguientes puntos: Si un security group pertenece a la red clásica, no se pueden referenciar listas de prefijos en sus reglas. Para obtener información sobre los límites de security groups y listas de prefijos, consulte la sección "Límites de security groups" en Límites. Si especifica el parámetro `SourceCidrIp`, `Ipv6SourceCidrIp` o `SourceGroupId`, este parámetro se ignora.
Permissions.N.PortRange	String	No	80/80	El rango de puertos de destino correspondiente al protocolo de capa de transporte para la regla N del security group. Valores válidos: Si el parámetro Permissions.N.IpProtocol se establece en TCP o UDP, el rango de números de puerto es de 1 a 65535. Especifique el rango de puertos con el formato <Número de puerto inicial>/<Número de puerto final>. Ejemplo: 1/200. Si el parámetro Permissions.N.IpProtocol se establece en ICMP, el rango de números de puerto es -1/-1, lo que indica todos los puertos. Si el parámetro Permissions.N.IpProtocol se establece en GRE, el rango de números de puerto es -1/-1, lo que indica todos los puertos. Si el parámetro Permissions.N.IpProtocol se establece en ALL, el rango de números de puerto es -1/-1, lo que indica todos los puertos. Para obtener más información, consulte Aplicaciones típicas de puertos comunes. Valores válidos de N: 1 a 100.
Permissions.N.DestCidrIp	String	No	10.0.0.0/8	El bloque CIDR IPv4 de destino para la regla N del security group. Se admiten bloques CIDR y direcciones IPv4. Este parámetro es compatible con las reglas de quintupla. Para obtener más información, consulte Reglas de quintupla de security group. Valores válidos de N: 1 a 100.
Permissions.N.Ipv6DestCidrIp	String	No	2001:250:6000::***	El bloque CIDR IPv6 de destino para la regla N del security group. Se admiten bloques CIDR y direcciones IPv6. Este parámetro es compatible con las reglas de quintupla. Para obtener más información, consulte Reglas de quintupla de security group. Valores válidos de N: 1 a 100. Nota El parámetro Permissions.N.Ipv6DestCidrIp solo es válido cuando el destino son instancias de ECS residentes en VPC que admiten bloques CIDR IPv6. No puede especificar este parámetro y el parámetro `DestCidrIp` simultáneamente.
Permissions.N.SourcePortRange	String	No	7000/8000	El rango de puertos de origen correspondiente al protocolo de capa de transporte para la regla N del security group. Valores válidos: Si el parámetro Permissions.N.IpProtocol se establece en TCP o UDP, el rango de números de puerto es de 1 a 65535. Especifique el rango de puertos con el formato <Número de puerto inicial>/<Número de puerto final>. Ejemplo: 1/200. Si el parámetro Permissions.N.IpProtocol se establece en ICMP, el rango de números de puerto es -1/-1, lo que indica todos los puertos. Si el parámetro Permissions.N.IpProtocol se establece en GRE, el rango de números de puerto es -1/-1, lo que indica todos los puertos. Si el parámetro Permissions.N.IpProtocol se establece en ALL, el rango de números de puerto es -1/-1, lo que indica todos los puertos. Este parámetro es compatible con las reglas de quintupla. Para obtener más información, consulte Reglas de quintupla de security group. Valores válidos de N: 1 a 100.
Permissions.N.SourceGroupOwnerAccount	String	No	test@aliyun.com	La cuenta de Alibaba Cloud que administra el security group de origen cuando se configura la regla N del security group entre cuentas. Si no se especifican `SourceGroupOwnerAccount` ni `SourceGroupOwnerId`, los permisos de acceso se configuran para otro security group administrado por su propia cuenta. Si se especifica `SourceCidrIp`, el parámetro `SourceGroupOwnerAccount` no surte efecto. Valores válidos de N: 1 a 100.
Permissions.N.SourceGroupOwnerId	Long	No	1234567890	El ID de la cuenta de Alibaba Cloud que administra el security group de origen cuando se configura la regla N del security group entre cuentas. Si no se especifican `SourceGroupOwnerAccount` ni `SourceGroupOwnerId`, los permisos de acceso se configuran para otro security group administrado por su propia cuenta. Si se especifica `SourceCidrIp`, el parámetro `SourceGroupOwnerAccount` no surte efecto. Valores válidos de N: 1 a 100.
Permissions.N.NicType	String	No	intranet	El tipo de controlador de interfaz de red (NIC) de la regla del security group cuando este pertenece a la red clásica. Valores válidos: internet: NIC pública intranet: NIC interna Si el security group está en una VPC, este parámetro se establece en intranet de forma predeterminada y no se puede modificar. Si solo especifica DestGroupId al configurar el acceso entre security groups, este parámetro debe establecerse en intranet. Valor predeterminado: internet. Valores válidos de N: 1 a 100.
Permissions.N.Description	String	No	This is description.	La descripción de la regla N del security group. La descripción debe tener una longitud de 1 a 512 caracteres. Valores válidos de N: 1 a 100.
Policy	String	No	accept	Este parámetro ha quedado descontinuado. Use `Permissions.N.Policy` para especificar si se permite el acceso de entrada.
Priority	String	No	1	Este parámetro ha quedado descontinuado. Use `Permissions.N.Priority` para especificar la prioridad de la regla.
IpProtocol	String	No	ALL	Este parámetro ha quedado descontinuado. Use `Permissions.N.IpProtocol` para especificar el protocolo de capa de transporte.
SourceCidrIp	String	No	10.0.0.0/8	Este parámetro ha quedado descontinuado. Use `Permissions.N.SourceCidrIp` para especificar el bloque CIDR IPv4 de origen.
Ipv6SourceCidrIp	String	No	2001:250:6000::***	Este parámetro ha quedado descontinuado. Use `Permissions.N.Ipv6SourceCidrIp` para especificar el bloque CIDR IPv6 de origen.
SourceGroupId	String	No	sg-bp67acfmxazb4p****	Este parámetro ha quedado descontinuado. Use `Permissions.N.SourceGroupId` para especificar el ID del security group de origen.
SourcePrefixListId	String	No	pl-x1j1k5ykzqlixdcy****	Este parámetro ha quedado descontinuado. Use `Permissions.N.SourcePrefixListId` para especificar el ID de la lista de prefijos de origen.
PortRange	String	No	22/22	Este parámetro ha quedado descontinuado. Use `Permissions.N.PortRange` para especificar el rango de puertos de destino.
DestCidrIp	String	No	10.0.0.0/8	Este parámetro ha quedado descontinuado. Use `Permissions.N.DestCidrIp` para especificar el bloque CIDR IPv4 de destino.
Ipv6DestCidrIp	String	No	2001:250:6000::***	Este parámetro ha quedado descontinuado. Use `Permissions.N.Ipv6DestCidrIp` para especificar el bloque CIDR IPv6 de destino.
SourcePortRange	String	No	22/22	Este parámetro ha quedado descontinuado. Use `Permissions.N.SourcePortRange` para especificar el rango de puertos de origen.
SourceGroupOwnerAccount	String	No	test@aliyun.com	Este parámetro ha quedado descontinuado. Use `Permissions.N.SourceGroupOwnerAccount` para especificar la cuenta de Alibaba Cloud que administra el security group de origen.
SourceGroupOwnerId	Long	No	1234567890	Este parámetro ha quedado descontinuado. Use `Permissions.N.SourceGroupOwnerId` para especificar el ID de la cuenta de Alibaba Cloud que administra el security group de origen.
NicType	String	No	intranet	Este parámetro ha quedado descontinuado. Use `Permissions.N.NicType` para especificar el tipo de NIC.
Description	String	No	This is description.	Este parámetro ha quedado descontinuado. Use `Permissions.N.Description` para especificar la descripción de la regla N del security group.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	El ID de la solicitud.

Ejemplos

Ejemplos de solicitudes

http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&SecurityGroupId=sg-bp67acfmxazb4p****
&Permissions.1.SourceCidrIp=10.0.0.0/8
&Permissions.1.IpProtocol=TCP
&Permissions.1.PortRange=22/22
&Permissions.1.NicType=intranet
&Permissions.1.Policy=accept
&Common request parameters

Ejemplos de respuestas exitosas

Formato XML

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

<AuthorizeSecurityGroupResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AuthorizeSecurityGroupResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	OperationDenied	The specified IpProtocol does not exist or IpProtocol and PortRange do not match.	El mensaje de error devuelto porque el parámetro IpProtocol especificado no existe o no coincide con el parámetro PortRange especificado.
400	InvalidIpProtocol.Malformed	The specified parameter PortRange is not valid.	El mensaje de error devuelto porque el parámetro IpProtocol o PortRange especificado no es válido.
400	InvalidSourceCidrIp.Malformed	The specified parameter SourceCidrIp is not valid.	El mensaje de error devuelto porque el bloque CIDR de origen especificado no es válido.
400	InvalidPolicy.Malformed	The specified parameter Policy is not valid.	El mensaje de error devuelto porque el parámetro Policy especificado no es válido.
400	InvalidNicType.ValueNotSupported	The specified NicType does not exist.	El mensaje de error devuelto porque el parámetro NicType especificado no existe.
400	InvalidSourceGroupId.Mismatch	Specified security group and source group are not in the same VPC.	El mensaje de error devuelto porque el security group especificado y el security group de origen no pertenecen a la misma VPC.
400	InvalidSourceGroup.NotFound	Specified source security group does not exist.	El mensaje de error devuelto porque la regla de entrada del security group especificada no existe o porque no se han especificado los parámetros relevantes.
400	InvalidPriority.Malformed	The parameter Priority is invalid.	El mensaje de error devuelto porque el parámetro Priority especificado no es válido.
400	InvalidSecurityGroup.InvalidNetworkType	The specified security group network type is not support this operation, please check the security group network types. For VPC security groups, ClassicLink must be enabled.	El mensaje de error devuelto porque la operación no es compatible con el tipo de red actual del security group. Debe habilitar ClassicLink para los security groups en VPC.
400	InvalidSecurityGroupId.Malformed	The specified parameter SecurityGroupId is not valid.	El mensaje de error devuelto porque el parámetro SecurityGroupId especificado no es válido.
400	InvalidParamter.Conflict	The specified SourceCidrIp should be different from the DestCidrIp.	El mensaje de error devuelto porque el valor de SourceCidrIp es idéntico al de DestCidrIp.
400	InvalidSourcePortRange.Malformed	The specified parameter SourcePortRange is not valid.	El mensaje de error devuelto porque el parámetro SourcePortRange especificado no es válido.
400	InvalidDestCidrIp.Malformed	The specified parameter DestCidrIp is not valid.	El mensaje de error devuelto porque el parámetro DestCidrIp especificado no es válido.
400	InvalidParameter.Conflict	IPv6 and IPv4 addresses cannot exist at the same time.	El mensaje de error devuelto porque se han especificado direcciones IPv6 e IPv4 simultáneamente.
400	InvalidParam.PrefixListAddressFamilyMismatch	The address family of the specified prefix list does not match the specified CidrIp.	El mensaje de error devuelto porque la familia de direcciones de la lista de prefijos especificada no coincide con la del bloque CIDR especificado.
400	NotSupported.ClassicNetworkPrefixList	The prefix list is not supported when the network type of security group is classic.	El mensaje de error devuelto porque los security groups en la red clásica no admiten listas de prefijos.
400	InvalidParam.SourceCidrIp	The specified param SourceCidrIp is not valid.	El mensaje de error devuelto porque el parámetro SourceCidrIp especificado no es válido.
400	InvalidParam.DestCidrIp	The specified param DestCidrIp is not valid.	El mensaje de error devuelto porque el parámetro DestCidrIp especificado no es válido.
400	MissingParameter	%s	El mensaje de error devuelto porque no se ha especificado un parámetro obligatorio.
400	InvalidParam.Permissions	The specified parameter Permissions cannot coexist with other parameters.	El mensaje de error devuelto porque un parámetro con el prefijo Permissions no se puede especificar al mismo tiempo que el parámetro correspondiente sin dicho prefijo.
400	InvalidParam.DuplicatePermissions	There are duplicate permissions in the specified parameter Permissions.	El mensaje de error devuelto porque las reglas de security group especificadas mediante los parámetros con el prefijo Permissions están duplicadas.
403	InvalidSourceGroupId.Mismatch	NicType is required or NicType expects intranet.	El mensaje de error devuelto porque el parámetro NicType no se ha especificado o no se ha establecido en intranet.
403	MissingParameter	The input parameter SourceGroupId or SourceCidrIp cannot be both blank.	El mensaje de error devuelto porque debe especificar como mínimo uno de los parámetros SourceGroupId o SourceCidrIp.
403	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.	El mensaje de error devuelto porque se ha alcanzado el número máximo de reglas en el security group.
403	InvalidParamter.Conflict	The specified SecurityGroupId should be different from the SourceGroupId.	El mensaje de error devuelto porque el security group de destino es el mismo que el security group de origen.
403	InvalidNetworkType.Mismatch	The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).	El mensaje de error devuelto porque el tipo de red del security group especificado difiere del tipo de red del security group de origen.
403	InvalidNetworkType.Conflict	The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).	El mensaje de error devuelto porque el tipo de red del security group especificado difiere del tipo de red del security group de origen.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	El mensaje de error devuelto porque no se pueden modificar los security groups administrados por servicios en la nube.
403	LimitExceed.PrefixListAssociationResource	The number of resources associated with the prefix list exceeds the limit.	El mensaje de error devuelto porque se ha alcanzado la cantidad máxima de recursos que se pueden asociar con la lista de prefijos.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	El mensaje de error devuelto porque el security group especificado no existe en esta cuenta. Compruebe si el ID del security group es correcto.
404	InvalidSourceGroupId.NotFound	The SourceGroupId provided does not exist in our records.	El mensaje de error devuelto porque el parámetro SourceGroupId especificado no existe.
404	InvalidPrefixListId.NotFound	The specified prefix list was not found.	El mensaje de error devuelto porque la lista de prefijos especificada no existe.
404	InvalidSecurityGroupId.NotFound	%s	El mensaje de error devuelto porque el ID de security group especificado no existe.
500	InternalError	The request processing has failed due to some unknown error.	El mensaje de error devuelto porque se ha producido un error interno. Inténtelo de nuevo más tarde.

Para consultar la lista de códigos de error, consulte Códigos de error del servicio.