ModifySecurityGroupRule - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Modifica uma regra de entrada do grupo de segurança em um grupo de segurança especificado.

Descrição da operação

Ao modificar regras de grupo de segurança especificando o ID da regra do grupo de segurança, observe os seguintes limites:

O objeto de autorização de uma regra de grupo de segurança pode ser um bloco CIDR IPv4 (ou endereço IP), um bloco CIDR IPv6 (ou endereço IP), um grupo de segurança ou uma lista de prefixos. Você não pode alterar o tipo de objeto de autorização para uma regra de grupo de segurança existente chamando esta operação. Por exemplo, se o tipo de objeto de autorização original for um bloco CIDR IPv4, você poderá alterá-lo para outro bloco CIDR IPv4 (ou endereço IP), mas não poderá alterá-lo para um bloco CIDR IPv6 (ou endereço IP), um grupo de segurança ou uma lista de prefixos.
Você não pode alterar um campo de um valor não vazio para um valor vazio. Para fazer essa alteração, adicione uma nova regra e, em seguida, exclua a regra atual.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do grupo de segurança de destino. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ClientToken	string	Não	O token do cliente que é usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para obter mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
SecurityGroupId	string	Sim	O ID do grupo de segurança.	sg-bp67acfmxazb4p****
SecurityGroupRuleId	string	Não	O ID da regra do grupo de segurança. Você pode chamar a operação DescribeSecurityGroupAttribute para consultar o ID da regra do grupo de segurança.	sgr-bp67acfmxa123b***
Policy	string	Não	A permissão de acesso. Valores válidos: accept: permite o acesso. drop: nega o acesso e não retorna uma mensagem de rejeição. Valor padrão: accept.	accept
Priority	string	Não	A prioridade da regra do grupo de segurança. Valores válidos: 1 a 100. Valor padrão: 1.	1
IpProtocol	string	Não	O protocolo da camada de rede ou da camada de transporte. Dois tipos de valores são suportados: Nomes de protocolo que não diferenciam maiúsculas de minúsculas. Valores válidos: ICMP GRE TCP UDP ALL: todos os protocolos. Números de protocolo que estão em conformidade com o padrão IANA, que são números inteiros de 0 a 255. Regiões suportadas: Filipinas Reino Unido Malásia Hohhot Qingdao Oeste dos EUA Singapura	ALL
SourceCidrIp	string	Não	O bloco CIDR IPv4 de origem. Os formatos CIDR e IPv4 para intervalos de endereços IP são suportados. Valor padrão: nenhum.	10.0.0.0/8
Ipv6SourceCidrIp	string	Não	O bloco CIDR IPv6 de origem. Os formatos CIDR e IPv6 para intervalos de endereços IP são suportados. Nota Apenas endereços IP do tipo VPC são suportados. Este parâmetro e o parâmetro SourceCidrIp não podem ser especificados ao mesmo tempo. Valor padrão: nenhum.	2001:db8:1233:1a00::***
SourceGroupId	string	Não	O ID do grupo de segurança de origem. Você deve especificar pelo menos um dos parâmetros SourceGroupId e SourceCidrIp. Se você especificar SourceGroupId, mas não especificar SourceCidrIp, o parâmetro NicType só poderá ser definido como intranet. Se você especificar SourceGroupId e SourceCidrIp, o SourceCidrIp terá precedência por padrão.	sg-bp67acfmxa123b****
SourcePrefixListId	string	Não	O ID da lista de prefixos de origem. Você pode chamar a operação DescribePrefixLists para consultar os IDs das listas de prefixos disponíveis. Se você especificar um dos parâmetros SourceCidrIp, Ipv6SourceCidrIp ou SourceGroupId, este parâmetro será ignorado.	pl-x1j1k5ykzqlixdcy****
PortRange	string	Não	O intervalo de portas de destino que estão abertas para o protocolo da camada de transporte no grupo de segurança de destino. Valores válidos: Para TCP e UDP: 1 a 65535. Use uma barra (/) para separar a porta inicial e a porta final. Exemplo: 1/200. Para ICMP: -1/-1. Para GRE: -1/-1. Para ALL: -1/-1.	80/80
DestCidrIp	string	Não	O bloco CIDR IPv4 de destino. Os formatos CIDR e IPv4 para intervalos de endereços IP são suportados. Valor padrão: nenhum.	10.0.0.0/8
Ipv6DestCidrIp	string	Não	O bloco CIDR IPv6 de destino. Os formatos CIDR e IPv6 para intervalos de endereços IP são suportados. Nota Apenas endereços IP do tipo VPC são suportados. Este parâmetro e o parâmetro DestCidrIp não podem ser especificados ao mesmo tempo. Valor padrão: nenhum.	2001:db8:1234:1a00::***
SourcePortRange	string	Não	O intervalo de portas de origem que estão abertas para o protocolo da camada de transporte no grupo de segurança de origem. Valores válidos: Para TCP e UDP: 1 a 65535. Use uma barra (/) para separar a porta inicial e a porta final. Exemplo: 1/200. Para ICMP: -1/-1. Para GRE: -1/-1. Para ALL: -1/-1.	80/80
SourceGroupOwnerAccount	string	Não	A conta Alibaba Cloud à qual o grupo de segurança de origem pertence quando você configura uma regra de grupo de segurança entre contas. Se nem SourceGroupOwnerAccount nem SourceGroupOwnerId forem especificados, a regra será considerada como configuração das permissões de acesso para outro grupo de segurança de sua própria conta. Se o parâmetro SourceCidrIp for especificado, o parâmetro SourceGroupOwnerAccount será inválido.	EcsforCloud@Alibaba.com
SourceGroupOwnerId	integer	Não	A conta Alibaba Cloud à qual o grupo de segurança de origem pertence quando você configura uma regra de grupo de segurança entre contas. Se nem SourceGroupOwnerId nem SourceGroupOwnerAccount forem especificados, a regra será considerada como configuração das permissões de acesso para outro grupo de segurança de sua própria conta. Se o parâmetro SourceCidrIp for especificado, o parâmetro SourceGroupOwnerId será inválido.	12345678910
NicType	string	Não	O tipo de NIC. Nota Você não pode modificar este parâmetro ao modificar uma regra especificando o ID da regra do grupo de segurança. Para modificar este parâmetro, adicione uma nova regra e, em seguida, exclua a regra atual.	intranet
Description	string	Não	A descrição da regra do grupo de segurança. A descrição deve ter de 1 a 512 caracteres de comprimento.	This is a new security group rule.
PortRangeListId	string	Não	O ID da lista de portas. Você pode chamar a operação DescribePortRangeLists para consultar os IDs das listas de portas disponíveis. Se você especificar o parâmetro PortRange, este parâmetro será ignorado. Para obter mais informações, consulte Limites do grupo de segurança.	prl-2ze9743****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied	The specified IpProtocol does not exist or IpProtocol and PortRange do not match.	O snapshot especificado não pode ser usado para criar um disco de dados.
400	InvalidIpProtocol.Malformed	The specified parameter PortRange is not valid.	O formato do parâmetro de protocolo IP é inválido e o parâmetro PortRange é inválido.
400	InvalidSourceCidrIp.Malformed	The specified parameter SourceCidrIp is not valid.	O formato do parâmetro de intervalo de endereços IP de origem é inválido.
400	InvalidPolicy.Malformed	The specified parameter Policy is not valid.	O parâmetro especificado é inválido. Verifique se o parâmetro está correto.
400	InvalidNicType.ValueNotSupported	The specified NicType does not exist.	O tipo de rede especificado não existe. Verifique se o tipo de rede está correto.
400	InvalidNicType.Mismatch	The specified NicType conflicts with the authorization record.	O tipo de NIC especificado entra em conflito com as informações da regra.
400	InvalidSourceGroupId.Mismatch	Specified security group and source group are not in the same VPC.	O grupo de segurança especificado e o grupo de segurança de origem não estão na mesma VPC.
400	InvalidSourceGroup.NotFound	Specified source security group does not exist.	A regra de entrada especificada do grupo de segurança não existe ou os parâmetros relevantes estão ausentes.
400	InvalidPriority.Malformed	The parameter Priority is invalid.	O parâmetro Priority especificado é inválido.
400	InvalidPriority.ValueNotSupported	The parameter Priority is invalid.	A prioridade da regra do grupo de segurança é inválida. O intervalo válido é de 1 a 100.
400	InvalidSecurityGroupDiscription.Malformed	The specified security group rule description is not valid.	A descrição do grupo de segurança especificada é inválida.
400	MissingParameter.Source	One of the parameters SourceCidrIp, SourceGroupId or SourcePrefixListId must be specified.	Os parâmetros SourceCidrIp e SourceGroupId não podem estar ambos vazios.
400	InvalidParam.PortRange	The specified parameter %s is not valid. It should be two integers less than 65535 in ?/? format.	Especifique um intervalo de portas de destino ou um intervalo de portas de origem. O número da porta deve ser menor que 65535. Use uma barra (/) para separar as portas inicial e final em um intervalo de portas.
400	InvalidIpProtocol.ValueNotSupported	The parameter IpProtocol must be specified with case insensitive TCP, UDP, ICMP, GRE or All.	O valor especificado para o parâmetro de protocolo IP não é suportado.
400	InvalidParam.SourceIp	The Parameters SourceCidrIp and Ipv6SourceCidrIp in %s cannot be set at the same time.	O parâmetro SourceIp especificado é inválido.
400	InvalidParam.DestIp	The Parameters DestCidrIp and Ipv6DestCidrIp in %s cannot be set at the same time.	O parâmetro DestIp especificado é inválido.
400	InvalidParam.Ipv6DestCidrIp	The specified parameter %s is not valid.	O parâmetro especificado é inválido.
400	InvalidParam.Ipv6SourceCidrIp	The specified parameter %s is not valid.	O parâmetro especificado é inválido.
400	InvalidParam.Ipv4ProtocolConflictWithIpv6Address	IPv6 address cannot be specified for IPv4-specific protocol.	O parâmetro especificado é inválido. Verifique se um endereço IPv6 foi especificado para o protocolo IPv4.
400	InvalidParam.Ipv6ProtocolConflictWithIpv4Address	IPv4 address cannot be specified for IPv6-specific protocol.	O parâmetro especificado é inválido. Verifique se um endereço IPv4 foi especificado para o protocolo IPv6.
400	InvalidParameter.Ipv6CidrIp	The specified Ipv6CidrIp is not valid.	O parâmetro Ipv6CidrIp especificado é inválido.
400	InvalidParam.DestCidrIp	The specified parameter %s is not valid.	O parâmetro DestCidrIp especificado é inválido.
400	InvalidSourcePortRange.Malformed	The specified parameter SourcePortRange is not valid.	O parâmetro SourcePortRange especificado é inválido.
400	InvalidSecurityGroupId.Malformed	The specified parameter SecurityGroupId is not valid.	O SecurityGroupId especificado é inválido.
400	InvalidParam.SourceCidrIp	The specified param SourceCidrIp is not valid.	O parâmetro SourceCidrIp é inválido.
400	InvalidParameter.Conflict	IPv6 and IPv4 addresses cannot exist at the same time.	Os parâmetros especificados estão em conflito entre si.
400	InvalidParam.SecurityGroupRuleId	The specified parameter SecurityGroupRuleId is not valid.	O parâmetro SecurityGroupRuleId especificado é inválido.
400	InvalidOperation.ModifySgRuleEntityType	The source or destination type of the rules cannot be modified.	O tipo de origem ou destino da regra não pode ser modificado.
400	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.	O número de regras de autorização no grupo de segurança atingiu o limite. Verifique se as regras de autorização são necessárias.
400	InvalidParam.ProtocolAndPortRangeMismatch	The specified Protocol and PortRange do not match.	O protocolo e o intervalo de portas especificados não correspondem.
400	InvalidParam.ProtocolAndAddressFamilyMismatch	The specified Protocol and address family do not match.	O protocolo e a família de endereços especificados não correspondem.
400	InvalidParam.PrefixListAddressFamilyMismatch	The address family of the prefix list does not match the rule.	A família de endereços da lista de prefixos especificada não corresponde à família de endereços do CidrIP especificado.
400	InvalidParam.InvalidModifyRuleRequest	The request parameters are illegal.	Os parâmetros da solicitação são inválidos.
400	InvalidOperation.ModifyNicType	NicType is not allowed to modify.	Não é permitido modificar o parâmetro NicType.
400	InvalidParamter.Conflict	The specified SourceCidrIp should be different from the DestCidrIp.	Os grupos de segurança autorizador e autorizado devem ser diferentes.
400	InvalidOperation.RuleDuplicate	%s.	A regra modificada duplica uma regra existente.
400	InvalidParam.ProtocolNotSupportPortRangeList	The specified protocol does not support the port range list.	O protocolo especificado não suporta listas de portas.
400	InvalidSourceOrDestGroupId.DirectionMissmatch	The specified SourceGroupId or DestGroupId does not match the direction of the rule.	O SourceGroupId ou DestGroupId especificado não corresponde à direção da regra do grupo de segurança.
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.	O tipo de intervalo de portas da regra do grupo de segurança não pode ser modificado. Não é possível alterar uma regra para usar ou deixar de usar uma lista de portas, ou vice-versa.
400	InvalidPortRangeListId.NotFound	The specified port range list was not found.	A lista de portas especificada não existe.
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.	Um parâmetro obrigatório está ausente.
403	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.
403	InvalidParamter.Conflict	The specified SecurityGroupId should be different from the SourceGroupId.	Os grupos de segurança autorizador e autorizado devem ser diferentes.
403	InvalidNetworkType.Mismatch	The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).	O tipo de rede da instância não oferece suporte ao método de cobrança de rede especificado.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Os grupos de segurança gerenciados por serviços de nuvem não podem ser modificados.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	O grupo de segurança especificado não existe na conta do usuário. Verifique se o ID do grupo de segurança está correto.
404	InvalidSourceGroupId.NotFound	The SourceGroupId provided does not exist in our records.	O grupo de segurança de entrada especificado não existe.
404	SecurityGroupRule.NotFound	The target security group rule not exist.	A regra do grupo de segurança de destino não existe.
404	InvalidPrefixListId.NotFound	The specified prefix list was not found.	A lista de prefixos não existe.
404	InvalidSecurityGroupRuleId.NotFound	The specified SecurityGroupRuleId is not exists.	O SecurityGroupRuleId especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.