ModifySecurityGroupEgressRule - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Modifica una regla de grupo de seguridad de salida.

Descripción de la operación

Cuando modifica una regla de grupo de seguridad especificando el ID de la regla, tenga en cuenta los siguientes límites:

El objeto de autorización de una regla de grupo de seguridad puede ser un bloque de Enrutamiento Inter-Dominio sin Clases (CIDR) IPv4 (o dirección IP), un bloque CIDR IPv6 (o dirección IP), un grupo de seguridad o una lista de prefijos. No puede utilizar esta operación para cambiar el tipo de objeto de autorización de una regla de grupo de seguridad existente. Por ejemplo, si el tipo de objeto de autorización original es un bloque CIDR IPv4, puede cambiarlo por otro bloque CIDR IPv4 (o dirección IP), pero no puede cambiarlo por un bloque CIDR IPv6 (o dirección IP), un grupo de seguridad o una lista de prefijos.
No puede cambiar el valor de un campo de un valor no vacío a un valor vacío. Para modificar reglas de grupo de seguridad en este caso, agregue una nueva regla y luego elimine la regla actual.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:ModifySecurityGroupEgressRule

update

*All Resource

*

ecs:tag
ecs:tag
ecs:SecurityGroupIpProtocols
ecs:SecurityGroupSourceCidrIps

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de región del grupo de seguridad de origen. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
RegionId	string	Sí	El ID de región del grupo de seguridad de origen. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero asegúrese de que el token sea único entre diferentes solicitudes. El valor de ClientToken solo puede contener caracteres ASCII y no puede superar los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-e89b-12d3-a456-426655440000
SecurityGroupId	string	Sí	El ID del grupo de seguridad.	sg-bp67acfmxazb4p****
SecurityGroupRuleId	string	No	El ID de la regla de grupo de seguridad. Puede llamar a DescribeSecurityGroupAttribute para consultar el ID de la regla de grupo de seguridad.	sgr-bp67acfmxazb4q****
Policy	string	No	Los permisos de acceso. Valores válidos: accept: acepta el acceso. drop: deniega el acceso y no devuelve una respuesta de rechazo. Valor predeterminado: accept.	accept
Priority	string	No	La prioridad de la regla de grupo de seguridad. Valores válidos: de 1 a 100. Valor predeterminado: 1.	1
IpProtocol	string	No	El protocolo de capa de red o de capa de transporte. Se admiten dos tipos de valores: Nombres de protocolo que no distinguen entre mayúsculas y minúsculas. Valores válidos: ICMP GRE TCP UDP ALL: se admiten todos los protocolos. Números de protocolo que cumplen con la especificación IANA, que son números enteros del 0 al 255. Las siguientes regiones admiten actualmente esta función: Filipinas Reino Unido (Londres) Malasia China (Hohhot) China (Qingdao) EE. UU. (Virginia) Singapur	tcp
DestCidrIp	string	No	El bloque de Enrutamiento Interclassless sin Dominio (CIDR) IPv4 de destino. Se admiten el formato CIDR y el rango de direcciones IP en formato IPv4. Valor predeterminado: null.	10.0.0.0/8
Ipv6DestCidrIp	string	No	El bloque de Enrutamiento Interclassless sin Dominio (CIDR) IPv6 de destino. Se admiten el formato CIDR y el rango de direcciones IP en formato IPv6. Nota Solo se admiten direcciones IP de tipo VPC. Este parámetro y `DestCidrIp` no se pueden especificar al mismo tiempo. No se permite configurar ambos parámetros simultáneamente. Valor predeterminado: null.	2001:db8:1233:1a00::***
DestGroupId	string	No	El ID del grupo de seguridad de destino al que desea otorgar permisos de acceso. Especifique al menos uno de `DestGroupId` y `DestCidrIp`. Especifique al menos uno de DestGroupId, DestCidrIp, Ipv6DestCidrIp y DestPrefixListId. Si se especifica DestGroupId pero no se especifica DestCidrIp, el parámetro NicType solo se puede establecer en intranet. Si se especifican tanto DestGroupId como DestCidrIp, DestCidrIp tiene prioridad.	sg-bp67acfmxa123b****
DestPrefixListId	string	No	El ID de la lista de prefijos de destino. Puede llamar a DescribePrefixLists para consultar los ID de listas de prefijos disponibles. Este parámetro se ignora si especifica uno de `DestCidrIp`, `Ipv6DestCidrIp` o `DestGroupId`.	pl-x1j1k5ykzqlixdcy****
PortRange	string	No	El rango de puertos de destino que corresponden al protocolo de capa de transporte. Valores válidos: Para TCP/UDP: los valores válidos son de 1 a 65535. Separe el puerto inicial y el puerto final con una barra diagonal (/). Ejemplo: 1/200. Para ICMP: -1/-1. Para GRE: -1/-1. Para ALL: -1/-1.	80/80
SourceCidrIp	string	No	El bloque de Enrutamiento Interclassless sin Dominio (CIDR) IPv4 de origen. Se admiten el formato CIDR y el rango de direcciones IP en formato IPv4. Valor predeterminado: null.	10.0.0.0/8
Ipv6SourceCidrIp	string	No	El bloque de Enrutamiento Interclassless sin Dominio (CIDR) IPv6 de origen. Se admiten el formato CIDR y el rango de direcciones IP en formato IPv6. Nota Solo se admiten direcciones IP de tipo VPC. Este parámetro y `SourceCidrIp` no se pueden especificar al mismo tiempo. No se permite configurar ambos parámetros simultáneamente. Valor predeterminado: null.	2001:db8:1234:1a00::***
SourcePortRange	string	No	El rango de puertos de origen que corresponden al protocolo de capa de transporte. Valores válidos: Para TCP/UDP: los valores válidos son de 1 a 65535. Separe el puerto inicial y el puerto final con una barra diagonal (/). Ejemplo: 1/200. Para ICMP: -1/-1. Para GRE: -1/-1. Para ALL: -1/-1.	80/80
DestGroupOwnerAccount	string	No	La cuenta de Alibaba Cloud propietaria del grupo de seguridad de destino cuando configura una regla de grupo de seguridad entre cuentas.	EcsforCloud@Alibaba.com
DestGroupOwnerId	integer	No	El ID de la cuenta de Alibaba Cloud propietaria del grupo de seguridad de destino cuando configura una regla de grupo de seguridad entre cuentas.	1234567890
NicType	string	No	El tipo de interfaz de red. Nota Cuando modifica una regla especificando el ID de la regla de grupo de seguridad, este parámetro no se puede modificar. Para realizar dicho cambio, agregue una nueva regla y luego elimine la regla actual.	intranet
Description	string	No	La descripción de la regla de grupo de seguridad. La descripción debe tener una longitud de 1 a 512 caracteres.	Esta es una nueva regla de grupo de seguridad
PortRangeListId	string	No	El ID de la libreta de direcciones de puertos. Puede llamar a `DescribePortRangeLists` para consultar los ID de libretas de direcciones de puertos disponibles. Este parámetro se ignora si especifica el parámetro PortRange. Para obtener más información, consulte Límites de grupos de seguridad.	prl-2ze9743****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	OperationDenied	The specified IpProtocol does not exist or IpProtocol and PortRange do not match.	The specified IP protocol does not exist or does not match the specified port range.
400	InvalidIpProtocol.Malformed	The specified parameter PortRange is not valid.	The specified IpProtocol or PortRange parameter is invalid.
400	InvalidDestCidrIp.Malformed	The specified parameter DestCidrIp is not valid.	The specified DestCidrIp parameter is invalid.
400	InvalidPolicy.Malformed	The specified parameter Policy is not valid.	The specified Policy parameter is invalid.
400	InvalidNicType.ValueNotSupported	The specified NicType does not exist.	The specified NicType parameter does not exist.
400	InvalidNicType.Mismatch	The specified NicType conflicts with the authorization record.	The specified NIC type does not match the existing rule.
400	InvalidDestGroupId.Mismatch	Specified security group and destination group are not in the same VPC.	The specified source and destination security groups do not belong to the same VPC.
400	InvalidDestGroup.NotFound	Specified destination security group does not exist.	The specified DestGroupId parameter does not exist.
400	InvalidPriority.Malformed	The specified parameter Priority is not valid.	The specified Priority parameter is invalid.
400	InvalidPriority.ValueNotSupported	The specified Priority is invalid.	Your specified priority is invalid.
400	InvalidSecurityGroupDiscription.Malformed	The specified security group rule description is not valid.	The specified security group rule description is invalid.
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.	The operation is not supported while the security group is of the current network type. If the network type is VPC, ClassicLink must be enabled.
400	MissingParameter.Dest	One of the parameters DestCidrIp, DestGroupId or DestPrefixListId must be specified.	At least one of the DestCidrIp, DestGroupId, and DestPrefixListId parameters must be specified.
400	InvalidParam.PortRange	The specified parameter %s is not valid. It should be two integers less than 65535 in ?/? format.	The format of the port range is invalid. Specify the port range in the format of a slash separating two integers.
400	InvalidIpProtocol.ValueNotSupported	The specified parameter IpProtocol should not be null and only tcp, udp, icmp, gre or all is supported. Ignore case.	The specified protocol type cannot be empty and must be a legal value.
400	InvalidParam.SourceIp	The Parameters SourceCidrIp and Ipv6SourceCidrIp in %s cannot be set at the same time.	The SourceCidrIp and Ipv6SourceCidrIp parameters cannot be specified at the same time.
400	InvalidParam.DestIp	The Parameters DestCidrIp and Ipv6DestCidrIp in %s cannot be set at the same time.	The DestCidrIp and Ipv6DestCidrIp parameters cannot be specified at the same time.
400	InvalidParam.Ipv6DestCidrIp	The specified parameter %s is not valid.	The specified Ipv6DestCidrIp parameter is invalid.
400	InvalidParam.Ipv6SourceCidrIp	The specified parameter %s is not valid.	The specified Ipv6SourceCidrIp parameter is invalid.
400	InvalidParam.Ipv4ProtocolConflictWithIpv6Address	IPv6 address cannot be specified for IPv4-specific protocol.	IPv6 addresses cannot be specified for instances that use the IPv4 protocol.
400	InvalidParam.Ipv6ProtocolConflictWithIpv4Address	IPv4 address cannot be specified for IPv6-specific protocol.	IPv4 addresses cannot be specified for instances that use the IPv6 protocol.
400	InvalidParameter.Ipv6CidrIp	The specified Ipv6CidrIp is not valid.	The specified Ipv6CidrIp parameter is invalid.
400	InvalidSourcePortRange.Malformed	The specified parameter SourcePortRange is not valid.	The specified SourcePortRange parameter is invalid.
400	InvalidParam.SourceCidrIp	The specified param SourceCidrIp is not valid.	The specified SourceCidrIp parameter is invalid.
400	InvalidParam.DestCidrIp	The specified param DestCidrIp is not valid.	The specified DestCidrIp parameter is invalid.
400	InvalidParameter.Conflict	IPv6 and IPv4 addresses cannot exist at the same time.	IPv6 and IPv4 addresses cannot be both specified.
400	InvalidParam.SecurityGroupRuleId	The specified parameter SecurityGroupRuleId is not valid.	The specified SecurityGroupRuleId parameter is invalid.
400	InvalidOperation.ModifySgRuleEntityType	The source or destination type of the rules cannot be modified.	The type of the source or destination in the rule cannot be modified.
400	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.	The security group has reached the maximum number of rules that can be added to it.
400	InvalidPrefixListId.NotFound	The specified prefix list was not found.
400	InvalidParam.ProtocolAndPortRangeMismatch	The specified Protocol and PortRange do not match.	The protocol and the port range do not match.
400	InvalidParam.ProtocolAndAddressFamilyMismatch	The specified Protocol and address family do not match.	The protocol and the address family do not match.
400	InvalidParam.PrefixListAddressFamilyMismatch	The address family of the prefix list does not match the rule.	The address family of the prefix list and the rule do not match.
400	InvalidParam.InvalidModifyRuleRequest	The request parameters are illegal.	The request parameter is invalid.
400	InvalidOperation.ModifyNicType	NicType is not allowed to modify.	The NicType parameter cannot be modified.
400	InvalidParamter.Conflict	The specified SourceCidrIp should be different from the DestCidrIp.	The value of SourceCidrIp must be different from that of DestCidrIp.
400	InvalidOperation.RuleDuplicate	%s.	The rule being modified will be duplicated with an existing rule.
400	InvalidParam.ProtocolNotSupportPortRangeList	The specified protocol does not support the port range list.	The specified protocol does not support the port list.
400	InvalidSourceOrDestGroupId.DirectionMissmatch	The specified SourceGroupId or DestGroupId does not match the direction of the rule.	The specified SourceGroupId or DestGroupId does not match the direction of the security group rule.
400	InvalidOperation.ModifyPortRangeType	The PortRange type is not allowed to be modified. You cannot modify a rule from using the port list to not using it, and vice versa.	The port range type of a security group rule cannot be modified. You cannot change a rule from using the port list to not using, and vice versa.
400	InvalidPortRangeListId.NotFound	The specified port range list was not found.	The specified port list was not found.
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidDestGroupId.Mismatch	NicType is required or NicType expects intranet.	The NicType parameter is not specified or is not set to intranet.
403	MissingParameter	The input parameter DestGroupId or DestCidrIp cannot be both blank.	The DestGroupId and DestCidrIp parameters are required.
403	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.
403	InvalidParamter.Conflict	The specified SecurityGroupId should be different from the SourceGroupId.	The destination security group is the same as the source security group.
403	InvalidNetworkType.Conflict	The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).	The network type of the destination security group is different from that of the source security group.
403	InvalidSecurityGroup.IsSame	The authorized SecurityGroupId should be different from the DestGroupId.	The ID of the source security group is the same as that of the destination security group.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	You cannot modify security groups managed by cloud services.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	The specified security group does not exist in this account. Check whether the security group ID is correct.
404	InvalidDestGroupId.NotFound	The DestGroupId provided does not exist in our records.	The specified outbound security group does not exist.
404	SecurityGroupRule.NotFound	The target security group rule do not exist.	The specified security group rule does not exist.
404	InvalidPrefixListId.NotFound	The specified prefix list was not found.	The prefix list does not exist.
404	InvalidSecurityGroupRuleId.NotFound	The specified SecurityGroupRuleId is not exists.	The specified SecurityGroupRuleId parameter does not exist.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.