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

Chama a operação ListVpcEndpointServicesByEndUser para obter uma lista de serviços de endpoint para os quais a conta atual está na lista de permissões. Esta lista inclui serviços aos quais você pode se conectar criando novos endpoints, bem como serviços que já estão conectados aos seus endpoints existentes.

Descrição da operação

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:ListVpcEndpointServicesByEndUser

get

*VpcEndpointService

acs:privatelink:{#regionId}:{#AccountId}:vpcendpointservice/*

privatelink:VpcEndpointServiceId

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Você pode chamar a operação DescribeRegions para obter o ID da região.	cn-huhehaote
NextToken	string	Não	O token de paginação. Se esta for sua primeira solicitação, não especifique este parâmetro. Se houver mais resultados disponíveis, defina este parâmetro com o valor NextToken da resposta anterior para obter a próxima página.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	Não	O número de entradas a serem retornadas em cada página. Valores válidos: 1 a 1000. Valor padrão: 50.	50
ServiceId	string	Não	O ID do serviço de endpoint.	epsrv-hp3vpx8yqxblby3i****
ServiceName	string	Não	O nome do serviço de endpoint.	com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3xdsq46ael67lo****
ServiceType	string	Não	O tipo do serviço de endpoint. Apenas Interface é suportado. Um endpoint de interface permite que você use Application Load Balancers (ALBs), Classic Load Balancers (CLBs) e Network Load Balancers (NLBs) como recursos de serviço.	Interface
RegionId	string	Sim	O ID da região. Você pode chamar a operação DescribeRegions para obter o ID da região.	cn-huhehaote
Tag	array<object>	Não	Uma lista de tags para filtrar recursos. Você pode especificar até 20 tags.
	object	Não	Um par chave-valor que compõe uma tag.
Key	string	Não	A chave da tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceJoshua
ResourceGroupId	string	Não	O ID do grupo de recursos.	rg-acfmy*****
ServiceRegionId	string	Não	O ID da região do serviço de endpoint.	cn-beijing

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Services	array<object>	Os serviços de endpoint.
	array<object>	Um serviço de endpoint.
Payer	string	O pagador. Valores válidos: Endpoint: o consumidor do serviço. EndpointService: o provedor do serviço.	Endpoint
ServiceDomain	string	O nome de domínio do serviço de endpoint.	epsrv-hp3vpx8yqxblby3i****.cn-huhehaote.privatelink.aliyuncs.com
Zones	array	As zonas onde o serviço de endpoint está disponível.
	string	A zona onde o serviço de endpoint está disponível.	cn-huhehaote-a
ServiceId	string	O ID do serviço de endpoint.	epsrv-hp3vpx8yqxblby3i****
ServiceName	string	O nome do serviço de endpoint.	com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****
ServiceType	string	O tipo do serviço de endpoint. O valor é sempre Interface. Isso indica um endpoint de interface onde você pode adicionar recursos de serviço como Application Load Balancer (ALB), Classic Load Balancer (CLB) e Network Load Balancer (NLB).	Interface
ServiceSupportIPv6	boolean	Indica se o serviço de endpoint suporta IPv6. Valores válidos: true: O serviço de endpoint suporta IPv6. false: O serviço de endpoint não suporta IPv6.	false
Tags	array<object>	Uma lista de tags.
	object	Uma tag.
Key	string	The tag key.	FinanceDept
Value	string	The tag value.	FinanceJoshua
ResourceGroupId	string	O ID do grupo de recursos.	rg-acfmy*****
ServiceResourceType	string	O tipo de recurso de serviço. slb: Uma instância de Classic Load Balancer (CLB). alb: Uma instância de Application Load Balancer (ALB). nlb: Uma instância de Network Load Balancer (NLB).	slb
AddressIpVersion	string	A versão do IP. Valores válidos: IPv4: O serviço suporta IPv4. DualStack: O serviço suporta IPv4 e IPv6 (pilha dupla).	IPv4
ZoneAffinityEnabled	boolean	Indica se a afinidade de zona está ativada. Valores válidos: true: A afinidade de zona está ativada. false: A afinidade de zona está desativada.	false
VpcEndpointPolicySupported	boolean
AutoAcceptEnabled	boolean	Indica se as solicitações de conexão são aceitas automaticamente. Valores válidos: true: As solicitações de conexão são aceitas automaticamente. false: As solicitações de conexão devem ser aceitas manualmente.	true
NextToken	string	O token usado para obter a próxima página de resultados. Valores válidos: Se este parâmetro estiver vazio, todos os resultados foram retornados. Se um valor for retornado, use-o em uma solicitação subsequente para obter a próxima página de resultados.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
MaxResults	integer	O número de entradas retornadas por página.	50
TotalCount	string	O número total de entradas.	29

Exemplos

Resposta de sucesso

JSON formato

{
  "Services": [
    {
      "Payer": "Endpoint",
      "ServiceDomain": "epsrv-hp3vpx8yqxblby3i****.cn-huhehaote.privatelink.aliyuncs.com",
      "Zones": [
        "cn-huhehaote-a"
      ],
      "ServiceId": "epsrv-hp3vpx8yqxblby3i****",
      "ServiceName": "com.aliyuncs.privatelink.cn-huhehaote.epsrv-hp3vpx8yqxblby3i****",
      "ServiceType": "Interface",
      "ServiceSupportIPv6": false,
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ],
      "ResourceGroupId": "rg-acfmy*****",
      "ServiceResourceType": "slb",
      "AddressIpVersion": "IPv4",
      "ZoneAffinityEnabled": false,
      "VpcEndpointPolicySupported": false,
      "AutoAcceptEnabled": true
    }
  ],
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "MaxResults": 50,
  "TotalCount": "29"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.