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

Consulta as conexões de endpoint chamando a operação ListVpcEndpointConnections.

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

list

*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 das conexões de endpoint que você deseja consultar. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-huhehaote
NextToken	string	Não	O token usado para a próxima consulta. Valores válidos: Não é necessário especificar este parâmetro na primeira consulta ou se nenhuma próxima consulta for enviada. Se uma próxima consulta for enviada, defina o valor como o valor de NextToken retornado na última chamada de API.	caeba0bbb2be03f84eb48b699f0a4883
MaxResults	integer	Não	O número de entradas por 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****
EniId	string	Não	O ID da interface de rede elástica (ENI) do endpoint.	eni-hp32lk0pyv6o94hs****
EndpointId	string	Não	O ID do endpoint.	ep-hp33b2e43fays7s8****
ConnectionStatus	string	Não	O estado da conexão do endpoint. Valores válidos: Pending: A conexão do endpoint está sendo modificada. Connecting: A conexão do endpoint está sendo estabelecida. Connected: O endpoint está conectado ao serviço de endpoint. Disconnecting: O endpoint está sendo desconectado do serviço de endpoint. Disconnected: O endpoint está desconectado do serviço de endpoint. Deleting: A conexão do endpoint está sendo excluída. ServiceDeleted: O serviço de endpoint correspondente foi excluído.	Disconnected
EndpointOwnerId	integer	Não	O ID da conta Alibaba Cloud à qual o endpoint pertence.	25346073170691****
ResourceId	string	Não	O ID do recurso de serviço.	lb-hp32z1wp5peaoox2q****
ReplacedResourceId	string	Não	O ID do recurso de serviço que é substituído no cenário de migração suave.	lb-hp32z1wp5peaoox2q****
RegionId	string	Sim	O ID da região das conexões de endpoint que você deseja consultar. Você pode chamar a operação DescribeRegions para consultar o ID da região.	cn-huhehaote
ResourceGroupId	string	Não	O ID do grupo de recursos ao qual o endpoint pertence.	rg-acfmy*****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Connections	array<object>	As informações sobre as conexões de endpoint.
	array<object>	As informações sobre as conexões de endpoint.
Zones	array<object>	As informações da zona.
	object	As informações da zona.
VSwitchId	string	The vSwitch to which the endpoint belongs.	vsw-hp3uf6045ljdhd5zr****
ZoneId	string	The zone ID.	cn-huhehaote-b
ResourceId	string	The service resource ID.	lb-hp32z1wp5peaoox2q****
EniId	string	The endpoint ENI ID.	eni-hp32lk0pyv6o94hs****
ZoneDomain	string	The domain name of the zone.	ep-hp34jaz8ykl0exwt**-cn-huhehaote.epsrv-hp3vpx8yqxblby3i**.cn-huhehaote-b.privatelink.aliyuncs.com
ZoneStatus	string	The state of the zone. Valid values: Creating: The zone is being created. Wait: The zone is waiting to be connected. Connected: The zone is connected. Deleting: The zone is being deleted. Disconnecting: The zone is being disconnected. Disconnected: The zone is disconnected. Connecting: The zone is being connected. Migrating: The zone is being migrated. Migrated: The zone is migrated.	Connected
ReplacedResourceId	string	The ID of the service resource that is replaced in the smooth migration scenario.	lb-hp32z1wp5peaoox2q****
ReplacedEniId	string	The ID of the endpoint ENI that is replaced in the smooth migration scenario.	eni-hp32lk0pyv6o94hs****
ModifiedTime	string	A hora em que a conexão foi modificada.	2021-09-28T10:34:46Z
Bandwidth	integer	A largura de banda da conexão do endpoint. Unidade: Mbit/s.	3072
EndpointOwnerId	integer	O ID da conta Alibaba Cloud à qual o endpoint pertence.	25346073170691****
ResourceOwner	boolean	Indica se o endpoint e o serviço de endpoint pertencem à mesma conta Alibaba Cloud. Valores válidos: true false	true
ServiceId	string	O ID do serviço de endpoint.	epsrv-hp3vpx8yqxblby3i****
ConnectionStatus	string	O estado da conexão do endpoint. Valores válidos: Pending: A conexão do endpoint está sendo modificada. Connecting: A conexão do endpoint está sendo estabelecida. Connected: O endpoint está conectado ao serviço de endpoint. Disconnecting: O endpoint está sendo desconectado do serviço de endpoint. Disconnected: O endpoint está desconectado do serviço de endpoint. Deleting: A conexão do endpoint está sendo excluída. ServiceDeleted: O serviço de endpoint correspondente foi excluído.	Disconnected
EndpointId	string	O ID do endpoint.	ep-hp33b2e43fays7s8****
EndpointVpcId	string	O ID da nuvem privada virtual (VPC) à qual o endpoint pertence.	vpc-hp356stwkxg3fn2xe****
ResourceGroupId	string	O ID do grupo de recursos ao qual o endpoint pertence.	rg-acfmw353z35v***
TrafficControlMode	string	Scalability: escalonamento automático. Neste modo, a largura de banda configurada para a conexão do endpoint não entra em vigor. BandwidthLimit: o limite de largura de banda da conexão do endpoint. O limite de largura de banda é o valor de Bandwidth.	BandwidthLimit
EndpointRegionId	string	O ID da região do endpoint.	cn-hangzhou
ServiceRegionId	string	O ID da região do serviço de endpoint.	cn-huhehaote
NextToken	string	O token usado para a próxima consulta. Valores válidos: Se NextToken estiver vazio, nenhuma próxima consulta será enviada. Se um valor de NextToken for retornado, o valor será o token usado para a próxima consulta.	caeba0bbb2be03f84eb48b699f0a4883
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
MaxResults	integer	O número de entradas por página.	50
TotalCount	string	O número de entradas retornadas na lista de conexões de endpoint.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "Connections": [
    {
      "Zones": [
        {
          "VSwitchId": "vsw-hp3uf6045ljdhd5zr****",
          "ZoneId": "cn-huhehaote-b",
          "ResourceId": "lb-hp32z1wp5peaoox2q****",
          "EniId": "eni-hp32lk0pyv6o94hs****",
          "ZoneDomain": "ep-hp34jaz8ykl0exwt****-cn-huhehaote.epsrv-hp3vpx8yqxblby3i****.cn-huhehaote-b.privatelink.aliyuncs.com",
          "ZoneStatus": "Connected",
          "ReplacedResourceId": "lb-hp32z1wp5peaoox2q****",
          "ReplacedEniId": "eni-hp32lk0pyv6o94hs****"
        }
      ],
      "ModifiedTime": "2021-09-28T10:34:46Z",
      "Bandwidth": 3072,
      "EndpointOwnerId": 0,
      "ResourceOwner": true,
      "ServiceId": "epsrv-hp3vpx8yqxblby3i****",
      "ConnectionStatus": "Disconnected",
      "EndpointId": "ep-hp33b2e43fays7s8****",
      "EndpointVpcId": "vpc-hp356stwkxg3fn2xe****",
      "ResourceGroupId": "rg-acfmw353z35v***",
      "TrafficControlMode": "BandwidthLimit",
      "EndpointRegionId": "cn-hangzhou",
      "ServiceRegionId": "cn-huhehaote"
    }
  ],
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "MaxResults": 50,
  "TotalCount": "1"
}

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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.