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

Modifica una regla de entrada de un security group especificado.

Descripción de la operación

Cuando modifica una regla de security group al especificar el ID de la regla, tenga en cuenta los siguientes límites:

El objeto de autorización de una regla de security group puede ser un bloque CIDR (Classless Inter-Domain Routing) IPv4 (o dirección IP), un bloque CIDR IPv6 (o dirección IP), un security group o una lista de prefijos. No puede utilizar esta operación para cambiar el tipo de objeto de autorización de una regla de security group 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 security group 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 security group 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:ModifySecurityGroupRule

update

*All Resource

*

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 security group. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
RegionId	string	Sí	El ID de región del security group. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
ClientToken	string	No	Un 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 parámetro ClientToken solo admite 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 security group.	sg-bp67acfmxazb4p****
SecurityGroupRuleId	string	No	El ID de la regla de security group. Puede llamar a DescribeSecurityGroupAttribute para consultar los ID de las reglas de security group.	sgr-bp67acfmxa123b***
Policy	string	No	Los permisos de acceso. Valores válidos: accept: acepta el acceso. drop: deniega el acceso y no devuelve una respuesta de denegación. Valor predeterminado: accept.	accept
Priority	string	No	La prioridad de la regla de security group. 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 sin distinción 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 las especificaciones de 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	ALL
SourceCidrIp	string	No	Configuración del bloque CIDR IPv4 de origen para los permisos de acceso. Se admiten rangos de direcciones IP en formato Classless Inter-Domain Routing (CIDR) y en formato IPv4. Valor predeterminado: null.	10.0.0.0/8
Ipv6SourceCidrIp	string	No	Configuración del bloque CIDR IPv6 de origen para los permisos de acceso. Se admiten rangos de direcciones IP en formato Classless Inter-Domain Routing (CIDR) y en formato IPv6. Nota Solo se admiten direcciones IP de tipo VPC. Este parámetro y `SourceCidrIp` no se pueden especificar al mismo tiempo. Valor predeterminado: null.	2001:db8:1233:1a00::***
SourceGroupId	string	No	Configuración del ID del security group de origen para los permisos de acceso. Especifique al menos uno de `SourceGroupId` y `SourceCidrIp`. Si se especifica `SourceGroupId` pero no `SourceCidrIp`, el parámetro `NicType` solo se puede establecer en intranet. Si se especifican tanto `SourceGroupId` como `SourceCidrIp`, `SourceCidrIp` tiene prioridad de forma predeterminada.	sg-bp67acfmxa123b****
SourcePrefixListId	string	No	Configuración del ID de la lista de prefijos de origen para los permisos de acceso. Puede invocar DescribePrefixLists para consultar los ID de listas de prefijos disponibles. Este parámetro se ignora si especifica uno de `SourceCidrIp`, `Ipv6SourceCidrIp` o `SourceGroupId`.	pl-x1j1k5ykzqlixdcy****
PortRange	string	No	El rango de puertos de destino que corresponden al protocolo de capa de transporte del security group. Valores válidos: TCP/UDP: los valores válidos van de 1 a 65535. Separe el puerto inicial y el puerto final con una barra diagonal (/). Ejemplo: 1/200. ICMP: -1/-1. GRE: -1/-1. ALL: -1/-1.	80/80
DestCidrIp	string	No	El bloque Classless Inter-Domain Routing (CIDR) IPv4 de destino. Se admiten rangos de direcciones IP en formato CIDR y en formato IPv4. Valor predeterminado: null.	10.0.0.0/8
Ipv6DestCidrIp	string	No	Configuración del bloque CIDR IPv6 de destino. Se admiten rangos de direcciones IP en formato Classless Inter-Domain Routing (CIDR) y en formato IPv6. Nota Solo se admiten direcciones IP de tipo VPC. Este parámetro y `DestCidrIp` no se pueden especificar al mismo tiempo. Valor predeterminado: null.	2001:db8:1234:1a00::***
SourcePortRange	string	No	El rango de puertos de origen que corresponden al protocolo de capa de transporte del security group. Valores válidos: TCP/UDP: los valores válidos van de 1 a 65535. Separe el puerto inicial y el puerto final con una barra diagonal (/). Ejemplo: 1/200. ICMP: -1/-1. GRE: -1/-1. ALL: -1/-1.	80/80
SourceGroupOwnerAccount	string	No	Configuración de la cuenta de Alibaba Cloud propietaria del security group de origen cuando configura una regla de security group entre cuentas para los permisos de acceso. Si no se configuran ni `SourceGroupOwnerAccount` ni `SourceGroupOwnerId`, la regla se configura para los permisos de acceso de sus otros security groups. Si se especifica el parámetro `SourceCidrIp`, el parámetro `SourceGroupOwnerAccount` no es válido.	EcsforCloud@Alibaba.com
SourceGroupOwnerId	integer	No	Configuración del ID de la cuenta de Alibaba Cloud propietaria del security group de origen cuando configura una regla de security group entre cuentas para los permisos de acceso. Si no se configuran ni `SourceGroupOwnerId` ni `SourceGroupOwnerAccount`, la regla se configura para los permisos de acceso de sus otros security groups. Si se especifica el parámetro `SourceCidrIp`, el parámetro `SourceGroupOwnerId` no es válido.	12345678910
NicType	string	No	El tipo de controlador de interfaz de red (NIC). Nota Cuando modifica una regla al especificar el ID de la regla de security group, 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 security group. La descripción debe tener una longitud de 1 a 512 caracteres.	Esta es una nueva regla de security group
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 security groups.	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	InvalidSourceCidrIp.Malformed	The specified parameter SourceCidrIp is not valid.	The specified source CIDR block 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	InvalidSourceGroupId.Mismatch	Specified security group and source group are not in the same VPC.	The specified source and destination security groups do not belong to the same VPC.
400	InvalidSourceGroup.NotFound	Specified source security group does not exist.	The specified inbound security group rule does not exist, or required parameters are not specified.
400	InvalidPriority.Malformed	The parameter Priority is invalid.	The specified Priority parameter is invalid.
400	InvalidPriority.ValueNotSupported	The parameter Priority is invalid.	The specified Priority parameter is invalid.
400	InvalidSecurityGroupDiscription.Malformed	The specified security group rule description is not valid.	The specified security group rule description is invalid.
400	MissingParameter.Source	One of the parameters SourceCidrIp, SourceGroupId or SourcePrefixListId must be specified.	The source of the security group rule must be specified. Specify any of the SourceCidrIp, SourceGroupId, or SourcePrefixListId parameters.
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 parameter IpProtocol must be specified with case insensitive TCP, UDP, ICMP, GRE or All.	The specified IpProtocol parameter is invalid. The valid values of this parameter are tcp, udp, icmp, gre, and all.
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	InvalidParam.DestCidrIp	The specified parameter %s is not valid.	The specified DestCidrIp parameter is invalid.
400	InvalidSourcePortRange.Malformed	The specified parameter SourcePortRange is not valid.	The specified SourcePortRange parameter is invalid.
400	InvalidSecurityGroupId.Malformed	The specified parameter SecurityGroupId is not valid.	The specified SecurityGroupId parameter is invalid.
400	InvalidParam.SourceCidrIp	The specified param SourceCidrIp is not valid.	The specified SourceCidrIp 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	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	InvalidSourceGroupId.Mismatch	NicType is required or NicType expects intrnet.
403	MissingParameter	The input parameter SourceGroupId or SourceCidrIp cannot be both blank.	At least one of the SourceGroupId and SourceCidrIp parameters must be specified.
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.Mismatch	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	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	InvalidSourceGroupId.NotFound	The SourceGroupId provided does not exist in our records.	The specified SourceGroupId parameter does not exist.
404	SecurityGroupRule.NotFound	The target security group rule 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.