ListVirtualPhysicalConnections - Express Connect: Central de Documentação do Alibaba Cloud

Consulta informações sobre circuitos Express Connect compartilhados.

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

vpc:ListVirtualPhysicalConnections

list

*PhysicalConnection.

acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
PhysicalConnectionId	string	Não	O ID do circuito Express Connect associado aos circuitos Express Connect compartilhados. No conteúdo a seguir deste tópico, o circuito Express Connect associado aos circuitos Express Connect compartilhados é referido como o circuito Express Connect, para distingui-lo dos circuitos Express Connect compartilhados.	pc-bp1ciz7ekd2grn1as****
VirtualPhysicalConnectionBusinessStatus	string	Não	O status comercial dos circuitos Express Connect compartilhados. Valores válidos: Normal: Normal. FinancialLocked: Bloqueado devido a pagamento em atraso. SecurityLocked: Bloqueado por motivos de segurança.	Normal
VirtualPhysicalConnectionIds	array	Não	As informações dos circuitos Express Connect compartilhados.	pc-xxx
	string	Não	O ID da instância dos circuitos Express Connect compartilhados. Você pode especificar vários IDs de instância. Valores válidos de N: 1 a 20.	pc-bp1mrgfbtmc9brre7****
IsConfirmed	boolean	Não	Especifica se os circuitos Express Connect compartilhados foram confirmados e aceitos pelo locatário. Valores válidos: true: Sim. false: Não.	true
VirtualPhysicalConnectionStatuses	array	Não	As informações de status comercial dos circuitos Express Connect compartilhados.	pc-xxx
	string	Não	O status comercial dos circuitos Express Connect compartilhados. Valores válidos: Confirmed: Os circuitos Express Connect compartilhados foram aceitos. UnConfirmed: Os circuitos Express Connect compartilhados não foram aceitos. Deleted: Os circuitos Express Connect compartilhados foram excluídos. Você pode especificar vários status comerciais. Valores válidos de N: 1 a 20.	Confirmed
VirtualPhysicalConnectionAliUids	array	Não	As informações da conta Alibaba Cloud do proprietário dos circuitos Express Connect compartilhados.	189xxx
	string	Não	O ID da conta Alibaba Cloud do proprietário dos circuitos Express Connect compartilhados. Você pode especificar vários IDs de conta Alibaba Cloud. Valores válidos de N: 1 a 20.	15346073170691****
VlanIds	array	Não	O ID da VLAN dos circuitos Express Connect compartilhados.	pc-xxx
	string	Não	O ID da VLAN dos circuitos Express Connect compartilhados. Você pode especificar vários IDs de VLAN. Valores válidos de N: 1 a 20.	10
MaxResults	integer	Não	O número de entradas por página quando você consulta resultados por página. Valores válidos: 1 a 100. Valor padrão: 20.	20
NextToken	string	Não	Especifica se existe um token de próxima consulta. Valores válidos: Você não precisa especificar este parâmetro na primeira consulta ou se não houver uma próxima consulta. Se existir uma próxima consulta, defina este parâmetro com o valor NextToken retornado pela chamada de API anterior.	dd20****
RegionId	string	Sim	O ID da região dos circuitos Express Connect compartilhados. Você pode invocar a operação DescribeRegions para consultar o ID da região.	cn-shanghai
Tags	array<object>	Não	A lista de tags.
	object	Não	A lista de tags.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres e pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Ela 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 do recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Ele 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 ao qual os circuitos Express Connect compartilhados pertencem.	rg-acfmxazb4p****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	2A55F69E-EE3D-5CBE-8805-734F7D5B46B9
VirtualPhysicalConnections	array<object>	A lista de circuitos Express Connect compartilhados.
	array<object>	Os detalhes dos circuitos Express Connect compartilhados.
Type	string	O tipo do circuito Express Connect. Valor padrão: VPC.	VPC
Status	string	O status do circuito Express Connect. Valores válidos: Initial: A solicitação está em análise. Approved: A solicitação foi aprovada. Allocating: Os recursos estão sendo alocados. Allocated: Em construção. Confirmed: Aguardando confirmação do usuário. Enabled: Ativado. Rejected: A solicitação foi rejeitada. Canceled: Cancelado. Allocation Failed: Falha na alocação de recursos. Terminated: Encerrado.	Enabled
CreationTime	string	A hora em que o circuito Express Connect foi criado. A hora é exibida no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2021-06-08T12:20:55Z
AdLocation	string	A localização física do dispositivo de acesso do circuito Express Connect.	Yuhang Economic Development Zone, XX Intersection, Yuhang XX Data Center, Room E***
PortNumber	string	O número da porta do dispositivo de acesso do circuito Express Connect.	80
Spec	string	O valor de largura de banda dos circuitos Express Connect compartilhados. Unidade: M indica Mbit/s e G indica Gbit/s.	50M
ChargeType	string	O método de cobrança do circuito Express Connect. Valores válidos: Prepaid, que indica assinatura.	Prepaid
Description	string	A descrição do circuito Express Connect.	desctest
Bandwidth	integer	A largura de banda do circuito Express Connect. Unidade: Mbit/s.	50
EnabledTime	string	A hora em que o circuito Express Connect foi ativado. A hora é exibida no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.	2021-10-08T10:44:00Z
LineOperator	string	A operadora que fornece a linha física para acesso. Valores válidos: CT: China Telecom. CU: China Unicom. CM: China Mobile. CO: Outras operadoras na China continental. Equinix: Equinix. Other: Outras operadoras fora da China continental.	CU
PeerLocation	string	A localização geográfica do data center on-premises.	No. XX, XX Street, XX District, Hangzhou, Zhejiang Province
RedundantPhysicalConnectionId	string	O ID do circuito Express Connect redundante.	pc-119mfjzm****
Name	string	O nome do circuito Express Connect.	nametest
CircuitCode	string	O código do circuito fornecido pela operadora para o circuito Express Connect.	longtel001
EndTime	string	A hora de expiração dos circuitos Express Connect compartilhados. A hora é exibida no padrão ISO 8601 no formato YYYY-MM-DDThh:mm:ssZ. A hora é exibida em UTC.	2021-11-08T16:00:00Z
PortType	string	O tipo de porta do dispositivo de acesso do circuito Express Connect. Valores válidos: 100Base-T: Porta Ethernet 100M. 1000Base-T: Porta elétrica GE. 1000Base-LX: Porta óptica monomodo GE (10 km). 10GBase-T: Porta elétrica 10 GE. 10GBase-LR: Porta óptica monomodo 10 GE (10 km). 40GBase-LR: Porta óptica monomodo 40 GE. 100GBase-LR: Porta óptica monomodo 100 GE.	10GBase-LR
BusinessStatus	string	O status comercial do circuito Express Connect. Valores válidos: Normal: Ativado. FinancialLocked: Bloqueado devido a pagamento em atraso. SecurityLocked: Bloqueado por motivos de segurança.	Normal
LoaStatus	string	O status da Carta de Autorização (LOA). Valores válidos: Applying: A solicitação da LOA está sendo processada. Accept: A solicitação da LOA foi aprovada. Available: A LOA está disponível. Rejected: A solicitação da LOA foi rejeitada. Completing: O circuito Express Connect está em construção. Complete: A construção do circuito Express Connect foi concluída. Deleted: A LOA foi excluída.	Available
AccessPointId	string	O ID do ponto de acesso do circuito Express Connect.	ap-cn-hangzhou-finance-yh-E
PhysicalConnectionId	string	O ID da instância dos circuitos Express Connect compartilhados.	pc-bp1mrgfbtmc9brre7****
ProductType	string	O tipo do circuito Express Connect. Valores válidos: VirtualPhysicalConnection: Circuitos Express Connect compartilhados. PhysicalConnection: Circuito Express Connect dedicado.	VirtualPhysicalConnection
ParentPhysicalConnectionId	string	O ID da instância do circuito Express Connect.	pc-bp1ciz7ekd2grn1as****
VirtualPhysicalConnectionStatus	string	O status comercial dos circuitos Express Connect compartilhados. Valores válidos: Confirmed: Os circuitos Express Connect compartilhados foram aceitos. UnConfirmed: Os circuitos Express Connect compartilhados não foram aceitos. Deleted: Os circuitos Express Connect compartilhados foram excluídos.	Confirmed
ParentPhysicalConnectionAliUid	string	O ID da conta Alibaba Cloud proprietária do circuito Express Connect.	18311773240248****
OrderMode	string	O pagador dos circuitos Express Connect compartilhados. Valores válidos: PayByPhysicalConnectionOwner: O proprietário do circuito Express Connect associado aos circuitos Express Connect compartilhados é o pagador. PayByVirtualPhysicalConnectionOwner: O proprietário dos circuitos Express Connect compartilhados é o pagador.	PayByPhysicalConnectionOwner
AliUid	string	O ID da conta Alibaba Cloud do proprietário dos circuitos Express Connect compartilhados.	15346073170691****
VlanId	string	O ID da VLAN dos circuitos Express Connect compartilhados.	10
ExpectSpec	string	O valor esperado de largura de banda dos circuitos Express Connect compartilhados. O valor esperado de largura de banda entra em vigor somente após a conclusão do pagamento. Unidade: M indica Mbit/s e G indica Gbit/s.	50M
ResourceGroupId	string	O ID do grupo de recursos ao qual os circuitos Express Connect compartilhados pertencem.	rg-acfm3wmsyui****
Tags	array<object>	A lista de tags.
	object	A lista de tags.
Key	string	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 64 caracteres e pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Ela não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	O valor da tag do recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e pode conter dígitos, pontos (.), sublinhados (_) e hifens (-). Ele não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceJoshua
NextToken	string	Indica se existe um token de próxima consulta. Valores válidos: Se NextToken estiver vazio, não há próxima consulta. Se NextToken tiver um valor de retorno, o valor é o token para a próxima consulta.	dd20****
TotalCount	integer	O número total de entradas retornadas.	1
Count	integer	O número de entradas retornadas na consulta atual.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2A55F69E-EE3D-5CBE-8805-734F7D5B46B9",
  "VirtualPhysicalConnections": [
    {
      "Type": "VPC",
      "Status": "Enabled",
      "CreationTime": "2021-06-08T12:20:55Z",
      "AdLocation": "Yuhang Economic Development Zone, XXX Intersection, Yuhang XX Data Center, Room E***",
      "PortNumber": "80",
      "Spec": "50M",
      "ChargeType": "Prepaid",
      "Description": "desctest",
      "Bandwidth": 50,
      "EnabledTime": "2021-10-08T10:44:00Z",
      "LineOperator": "CU",
      "PeerLocation": "No. XX, XX Street, XX District, Hangzhou, Zhejiang Province",
      "RedundantPhysicalConnectionId": "pc-119mfjzm****",
      "Name": "nametest",
      "CircuitCode": "longtel001",
      "EndTime": "2021-11-08T16:00:00Z",
      "PortType": "10GBase-LR",
      "BusinessStatus": "Normal",
      "LoaStatus": "Available",
      "AccessPointId": "ap-cn-hangzhou-finance-yh-E",
      "PhysicalConnectionId": "pc-bp1mrgfbtmc9brre7****",
      "ProductType": "VirtualPhysicalConnection",
      "ParentPhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
      "VirtualPhysicalConnectionStatus": "Confirmed",
      "ParentPhysicalConnectionAliUid": "18311773240248****",
      "OrderMode": "PayByPhysicalConnectionOwner",
      "AliUid": "15346073170691****",
      "VlanId": "10",
      "ExpectSpec": "50M",
      "ResourceGroupId": "rg-acfm3wmsyui****",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ]
    }
  ],
  "NextToken": "dd20****",
  "TotalCount": 1,
  "Count": 1
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.Bandwidth	The param of Bandwidth [%s] is illegal.	A largura de banda especificada é inválida.
400	ResourceNotFound.PhysicalConnectionId	The specified PhysicalConnectionId [%s] is not found.	O PhysicalConnectionId não foi encontrado.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.