UpdateVpcEndpointServiceAttribute - PrivateLink: Central de Documentação do Alibaba Cloud

Chama a operação UpdateVpcEndpointServiceAttribute para modificar os atributos de um serviço de endpoint.

Descrição da operação

Antes de modificar os atributos de um serviço de endpoint, certifique-se de que o serviço de endpoint esteja no estado Active. Você pode chamar a operação GetVpcEndpointServiceAttribute para consultar o status do serviço de endpoint.
A operação UpdateVpcEndpointServiceAttribute não suporta a modificação simultânea de atributos do serviço de endpoint dentro da mesma conta Alibaba Cloud.

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

privatelink:UpdateVpcEndpointServiceAttribute

update

*VpcEndpointService

acs:privatelink:{#regionId}:{#accountId}:vpcendpointservice/{#ServiceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do serviço de endpoint. 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 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 único entre diferentes solicitações. O parâmetro ClientToken suporta apenas caracteres ASCII.	0c593ea1-3bea-11e9-b96b-88e9fe637760
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run, sem executar a solicitação real. Valores válidos: true: realiza apenas um dry run. O sistema verifica a solicitação em busca de possíveis problemas, incluindo valores de parâmetros ausentes, sintaxe de solicitação incorreta e limites de serviço. Se a solicitação falhar no dry run, um código de erro será retornado. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado. false (padrão): realiza um dry run e executa a solicitação real. Se a solicitação passar no dry run, um código de status HTTP 2xx será retornado e os atributos do recurso serão modificados.	false
ServiceId	string	Sim	O ID do serviço de endpoint.	epsrv-hp3vpx8yqxblby3i****
ServiceDescription	string	Não	A descrição do serviço de endpoint.	This is my EndpointService.
AutoAcceptEnabled	boolean	Não	Especifica se as conexões de endpoint devem ser aceitas automaticamente. Valores válidos: true: aceita automaticamente as conexões de endpoint. false: não aceita automaticamente as conexões de endpoint.	false
ConnectBandwidth	integer	Não	O limite de largura de banda padrão. Valor padrão: 3072. Unidade: Mbit/s. Valores válidos: 100 a 10240. Nota As configurações para o limite de largura de banda padrão são suportadas quando o recurso de serviço é uma instância Classic Load Balancer (CLB) ou uma instância Application Load Balancer (ALB). Quando o recurso de serviço é uma instância Network Load Balancer (NLB), a largura de banda da conexão não pode ser configurada.	3072
ZoneAffinityEnabled	boolean	Não	Especifica se o nome de domínio do endpoint conectado ao serviço de endpoint deve ser resolvido para o ponto de acesso mais próximo. Valores válidos: true (padrão): sim. false: não.	true
RegionId	string	Sim	O ID da região do serviço de endpoint. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ServiceSupportIPv6 `deprecated`	boolean	Não	Especifica se o serviço de endpoint suporta IPv6. Valores válidos: true: sim. false (padrão): não.	false
AddressIpVersion	string	Não	A versão do protocolo. Valores válidos: IPv4: IPv4. DualStack: dual-stack. Nota Atualmente, apenas serviços de endpoint cujo tipo de recurso de backend é NLB ou GWLB suportam a configuração do protocolo de endereço IP como DualStack.	IPv4
AddSupportedRegionSet	array	Não	A lista de regiões remotas a serem adicionadas ao serviço de endpoint.
	string	Não	O ID da região remota a ser adicionada ao serviço de endpoint.	cn-huhehaote
DeleteSupportedRegionSet	array	Não	A lista de regiões remotas a serem removidas do serviço de endpoint.
	string	Não	O ID da região remota a ser removida do serviço de endpoint.	cn-beijing

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da solicitação.
RequestId	string	O ID da solicitação.	8D8992C1-6712-423C-BAC5-E5E817484C6B

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "8D8992C1-6712-423C-BAC5-E5E817484C6B"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	EndpointServiceNotFound	The specified Service does not exist.	The specified Service does not exist.
400	EndpointServiceLocked	The specified Service is locked.	The specified Service is locked.
400	EndpointServiceOperationDenied	The specified operation of endpoint service is not allowed.	The specified operation of endpoint service is not allowed.
400	IllegalParamFormat.%s	The param format of %s is illegal.	The parameter format of %s is illegal.
400	OperationDenied.PrivateServiceDomainBusinessStatus	The operation is not allowed because of PrivateServiceDomainBusinessStatus.
400	MissingParam.%s	The param of %s is missing.	The parameter %s is missing.
400	ServiceResourceNotSupportIpv6	The resource is not support ipv6.	The endpoint service does not support IPv6.
400	EndpointServiceDowngradeNotAllowed	The EndpointService is not allowed for downgrade.	The endpoint service is not allowed to be downgraded.
400	DependencyViolation.PrivateDnsName	The specified resource of %s depends on %s, so the operation cannot be completed.
400	OperationDenied.PrivateDomainNotSupport	The operation is not allowed because of PrivateDomainNotSupport.
400	OperationDenied.PrivateDomainStatusNotSupport	The operation is not allowed because of %s.
400	Conflict.ServiceName	The ServiceName %s is conflict.
400	InvalidParam.PrivateDnsName	The parameter of PrivateDnsName is illegal, which needs to end with aliyun.com, aliyun-inc.com, or aliyuncs.com.
400	OperationDenied.ResourceTypeNotSupportDualStack	The specified resource type does not support dualstack.	The specified resource type does not support dualstack.
400	OperationDenied.ServiceResourceIpVersionMismatch	The endpoint service and service resource AddressIpVersion do not match.	The endpoint service and service resource AddressIpVersion do not match.
400	EndpointServiceConnectionDependence	There are connections between the endpoint service and the dualstack endpoint, the endpoint service address ip version not support switching from dualstack to ipv4.	There are connections between the endpoint service and the dualstack endpoint, the endpoint service address ip version not support switching from dualstack to ipv4.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.