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

Modifica o nome e as entradas de uma lista de intervalos de portas especificada. Você pode adicionar, modificar e excluir entradas.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:ModifyPortRangeList

update

*PortRangeList

acs:ecs:{#regionId}:{#accountId}:portrangelist/{#portRangeListId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da lista de intervalos de portas. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ClientToken	string	Não	O ID da região da lista de intervalos de portas. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
PortRangeListId	string	Sim	O token de cliente usado para garantir a idempotência da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PortRangeListName	string	Não	O ID da lista de intervalos de portas a ser modificada.	prl-2ze9743****
Description	string	Não	O nome da lista de intervalos de portas. O nome deve ter de 2 a 128 caracteres e deve começar com uma letra ou um caractere chinês. Não pode começar com http://, https://, com.aliyun ou com.alibabacloud. Pode conter letras, caracteres chineses, dígitos, dois-pontos (:), sublinhados (_), pontos (.) e hifens (-).	Amostra_NomeListaIntervaloPortas
AddEntry	array<object>	Não	A descrição da lista de intervalos de portas. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.	Esta é a descrição
	object	Não	A entrada a ser adicionada ou modificada na lista de intervalos de portas.
PortRange	string	Não	O intervalo de portas. Valores válidos de N: 0 a 200. Configurações: O número de entradas não pode exceder a capacidade máxima de entradas (`MaxEntries`). Você não pode especificar valores duplicados para `PortRange`. O valor não pode ser igual ao valor do parâmetro `RemoveEntry.N.PortRange`.	80/80
Description	string	Não	A descrição do intervalo de portas. A descrição deve ter de 2 a 32 caracteres e não pode começar com http:// ou https://. Valores válidos de N: 0 a 200.	This is description.
RemoveEntry	array<object>	Não	As entradas a serem adicionadas ou modificadas na lista de intervalos de portas.
	object	Não	A entrada a ser adicionada ou modificada na lista de intervalos de portas.
PortRange	string	Não	O intervalo de portas. Valores válidos de N: 0 a 200. Configurações: O número de entradas não pode exceder o número máximo de entradas (MaxEntries). Você não pode especificar valores de PortRange duplicados. O valor não pode ser igual a um valor de parâmetro RemoveEntry.N.PortRange.	80/80

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
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	InvalidOperation.Conflict	The port range list has conflict task.	Existe uma tarefa conflitante na lista de portas.
400	InvalidPortRangeListId.NotFound	The specified port range list was not found.	A lista de portas especificada não foi encontrada.
400	InvalidOperation.MaxEntriesCountExceed	The specified MaxEntries exceeded the upper limit.	O parâmetro MaxEntries especificado excede o valor máximo permitido.
400	InvalidOperation.EntryCountExceedMaxEntries	The number of entries in the port list exceeds MaxEntries.	O número especificado de entradas excede o valor MaxEntries da lista de portas.
400	LimitExceed.MaxEntries	The number of entries exceeds the MaxEntries of the specified PortRangeList.	O número de entradas na lista de portas excedeu o valor de MaxEntries.
400	LimitExceed.Entry	The number of entries added or removed exceeds the limit.	O número de entradas adicionadas ou excluídas em uma única operação excedeu o limite.
400	InvalidParameter.PortRangeDuplicated	The specified PortRange is duplicated.	O intervalo de portas especificado está duplicado.
400	InvalidParameter.PortRangeListName	The specified parameter PortRangeListName is not valid.	O nome da lista de portas especificado é inválido.
400	InvalidMaxEntries.LessThanCurrentEntries	The specified MaxEntries is less than current entries.	O número máximo de entradas na lista de portas é menor que o número atual de entradas.
400	InvalidParameter.PortRange	The specified parameter PortRange is not valid. It should be two integers less than 65535 in specified format.	A entrada PortRange na lista de portas não atende aos requisitos de formato. Especifique dois números inteiros menores que 65535, separados por uma barra.
400	MissingParameter	Missing mandatory parameter.	Pelo menos um dos parâmetros especificados deve ser fornecido. Eles não podem estar todos vazios.
400	InvalidDescription.Malformed	The specifid Description is not valid.	O parâmetro description especificado é inválido.
403	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.
404	InvalidRegionId.NotFound	The specified parameter RegionId is not valid.	As informações da região são inválidas.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.