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

Chama a operação ListVirtualPhysicalConnections para consultar conexões físicas virtuais.

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 da conexão física associada à conexão física virtual.	pc-bp1ciz7ekd2grn1as****
VirtualPhysicalConnectionBusinessStatus	string	Não	O status comercial da conexão física virtual. Valores válidos: Normal: A conexão está operando normalmente. FinancialLocked: A conexão está bloqueada devido a um pagamento em atraso. SecurityLocked: A conexão está bloqueada por motivos de segurança.	Normal
VirtualPhysicalConnectionIds	array	Não	Os IDs das conexões físicas virtuais.	pc-xxx
	string	Não	O ID de uma conexão física virtual.	pc-bp1mrgfbtmc9brre7****
IsConfirmed	boolean	Não	Indica se o locatário aceitou a conexão física virtual. Valores válidos: true: A conexão foi aceita. false: A conexão não foi aceita.	true
VirtualPhysicalConnectionStatuses	array	Não	Os status comerciais das conexões físicas virtuais.	pc-xxx
	string	Não	O status comercial da conexão física virtual. Valores válidos: Confirmed: A conexão foi aceita. UnConfirmed: A conexão está com aceitação pendente. Deleted: A conexão foi excluída.	Confirmed
VirtualPhysicalConnectionAliUids	array	Não	As contas da Alibaba Cloud que possuem as conexões físicas virtuais.	189xxx
	string	Não	O ID da conta principal que possui a conexão física virtual.	15346073170691****
VlanIds	array	Não	Os IDs de VLAN das conexões físicas virtuais.	pc-xxx
	string	Não	O ID de VLAN da conexão física virtual.	10
MaxResults	integer	Não	O número de entradas a serem retornadas por página. Valores válidos: 1 a 100. Valor padrão: 20.	20
NextToken	string	Não	O token usado para recuperar a próxima página de resultados. Valores válidos: Deixe este parâmetro vazio para a primeira solicitação. Para solicitações subsequentes, defina este parâmetro com o valor `NextToken` retornado da solicitação anterior.	dd20****
RegionId	string	Sim	O ID da região onde a conexão física virtual está localizada. Você pode chamar a operação DescribeRegions para obter a lista mais recente de regiões.	cn-shanghai
Tags	array<object>	Não	A lista de tags.
	object	Não	Uma tag, que consiste em um par chave-valor.
Key	string	Não	A chave da tag. Você pode especificar até 20 tags. A chave da tag não pode ser uma string vazia. A chave 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. Você pode especificar até 20 tags. O valor da tag pode ser uma string vazia. O valor 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 a conexão física virtual pertence.	rg-acfmxazb4p****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	2A55F69E-EE3D-5CBE-8805-734F7D5B46B9
VirtualPhysicalConnections	array<object>	Uma lista de conexões físicas virtuais.
	array<object>	Os detalhes de uma conexão física virtual.
Type	string	O tipo da conexão física. O valor padrão é VPC.	VPC
Status	string	O status da conexão física. 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: A conexão está pronta para provisionamento. Confirmed: Aguardando confirmação do usuário. Enabled: A conexão está ativada. Rejected: A solicitação foi rejeitada. Canceled: A solicitação foi cancelada. Allocation Failed: A alocação de recursos falhou. Terminated: A conexão foi encerrada.	Enabled
CreationTime	string	A hora em que a conexão física foi criada.	2021-06-08T12:20:55
AdLocation	string	A localização física do dispositivo de acesso para a conexão física.	余杭经济开发区XXX交叉口, 余杭XX机房, E***包间
PortNumber	string	O número da porta do dispositivo de acesso para a conexão física.	80
Spec	string	A largura de banda da conexão física virtual. M indica Mbps e G indica Gbps.	50M
ChargeType	string	O método de cobrança da conexão física. O único valor válido é Prepaid, que corresponde ao método de cobrança por assinatura.	Prepaid
Description	string	A descrição da conexão física.	desctest
Bandwidth	integer	A largura de banda da conexão física. Unidade: Mbps.	50
EnabledTime	string	A hora em que a conexão física foi ativada.	2021-10-08T10:44Z
LineOperator	string	A operadora que fornece a conexão física. Os valores válidos incluem: CT: China Telecom. CU: China Unicom. CM: China Mobile. CO: outras operadoras chinesas. Equinix: Equinix. Other: outras operadoras fora da China.	CU
PeerLocation	string	A localização do data center local.	浙江省杭州市XX区XX街道XX号
RedundantPhysicalConnectionId	string	O ID da conexão física redundante.	pc-119mfjzm****
Name	string	O nome da conexão física.	nametest
CircuitCode	string	O código do circuito da conexão física, que é fornecido pela operadora.	longtel001
EndTime	string	O horário de expiração da conexão física virtual. O horário está em UTC e segue o formato `YYYY-MM-DDThh:mm:ssZ` (ISO 8601).	2021-11-08T16:00:00Z
PortType	string	O tipo de porta do ponto de acesso da conexão física. Valores válidos: 100Base-T: porta de cobre de 100 Mbps. 1000Base-T: porta de cobre de 1 Gbps. 1000Base-LX: porta óptica monomodo de 1 Gbps (10 km). 10GBase-T: porta de cobre de 10 Gbps. 10GBase-LR: porta óptica monomodo de 10 Gbps (10 km). 40GBase-LR: porta óptica monomodo de 40 Gbps. 100GBase-LR: porta óptica monomodo de 100 Gbps.	10GBase-LR
BusinessStatus	string	O status comercial da conexão física. Valores válidos: Normal: A conexão está funcionando conforme o esperado. FinancialLocked: A conexão está bloqueada devido a um pagamento em atraso. SecurityLocked: A conexão está bloqueada 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 foi gerada e está pronta para uso. Rejected: A solicitação da LOA foi rejeitada. Completing: A conexão física está sendo provisionada. Complete: O provisionamento foi concluído. Deleted: A LOA foi excluída.	Available
AccessPointId	string	O ID do ponto de acesso.	ap-cn-hangzhou-finance-yh-E
PhysicalConnectionId	string	O ID da conexão física virtual.	pc-bp1mrgfbtmc9brre7****
ProductType	string	O tipo da conexão física. Valores válidos: VirtualPhysicalConnection: uma conexão física virtual. PhysicalConnection: uma conexão física dedicada.	VirtualPhysicalConnection
ParentPhysicalConnectionId	string	O ID da conexão física pai.	pc-bp1ciz7ekd2grn1as****
VirtualPhysicalConnectionStatus	string	O status comercial da conexão física virtual. Valores válidos: Confirmed: A conexão física virtual foi aceita pelo destinatário. UnConfirmed: A conexão física virtual está aguardando aceitação. Deleted: A conexão física virtual foi excluída.	Confirmed
ParentPhysicalConnectionAliUid	string	O ID da conta da Alibaba Cloud que possui a conexão física pai.	18311773240248****
OrderMode	string	O método de cobrança da conexão física virtual. Valores válidos: PayByPhysicalConnectionOwner: O proprietário da conexão física pai paga. PayByVirtualPhysicalConnectionOwner: O proprietário da conexão física virtual paga.	PayByPhysicalConnectionOwner
AliUid	string	O ID da conta da Alibaba Cloud que possui a conexão física virtual.	15346073170691****
VlanId	string	O ID de VLAN da conexão física virtual.	10
ExpectSpec	string	A largura de banda esperada para a conexão física virtual. Esta largura de banda é aplicada após a conclusão do pagamento. M indica Mbps e G indica Gbps.	50M
ResourceGroupId	string	O ID do grupo de recursos ao qual a conexão física virtual pertence.	rg-acfm3wmsyui****
Tags	array<object>	Uma lista de tags.
	object	Os detalhes da tag.
Key	string	The tag key, which cannot be an empty string. You can specify up to 20 tag keys. The key can be up to 64 characters in length and can contain digits, periods (.), underscores (_), and hyphens (-). The key cannot start with `aliyun` or `acs:` and cannot contain `http://` or `https://`.	FinanceDept
Value	string	The tag value. You can specify up to 20 tag values. The tag value can be an empty string. The value can be up to 128 characters in length. It can contain digits, periods (.), underscores (_), and hyphens (-). It cannot start with `aliyun` or `acs:` and cannot contain `http://` or `https://`.	FinanceJoshua
NextToken	string	Um token de paginação. Ele pode ser usado na próxima solicitação para recuperar uma nova página de resultados. Valores válidos: Se NextToken não for retornado, não há mais resultados disponíveis. Se um valor for retornado para NextToken, use-o na próxima solicitação para recuperar a página subsequente de resultados.	dd20****
TotalCount	integer	O número total de entradas.	1
Count	integer	O número de entradas retornadas nesta solicitação.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2A55F69E-EE3D-5CBE-8805-734F7D5B46B9",
  "VirtualPhysicalConnections": [
    {
      "Type": "VPC",
      "Status": "Enabled",
      "CreationTime": "2021-06-08T12:20:55",
      "AdLocation": "余杭经济开发区XXX交叉口, 余杭XX机房, E***包间",
      "PortNumber": "80",
      "Spec": "50M",
      "ChargeType": "Prepaid",
      "Description": "desctest",
      "Bandwidth": 50,
      "EnabledTime": "2021-10-08T10:44Z",
      "LineOperator": "CU",
      "PeerLocation": "浙江省杭州市XX区XX街道XX号",
      "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.	The specified bandwidth value is invalid.
400	ResourceNotFound.PhysicalConnectionId	The specified PhysicalConnectionId [%s] is not found.	PhysicalConnectionId is set to an invalid value.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.