DescribePhysicalConnections - Express Connect - Centre de documentation Alibaba Cloud

Consulte les informations sur les circuits Express Connect dans une région spécifiée.

Description de l'opération

Par défaut, le système consulte les informations de tous les circuits Express Connect dans la région spécifiée. Vous pouvez utiliser les options de filtrage fournies par l'opération DescribePhysicalConnections pour consulter les informations de circuits Express Connect spécifiques. Pour les options de filtrage prises en charge par le système, consultez la description de Key dans la section Paramètres de requête de cette rubrique.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

vpc:DescribePhysicalConnections

list

*PhysicalConnection.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du circuit Express Connect. Vous pouvez appeler l'opération DescribeRegions pour obtenir l'identifiant de la région.	cn-hangzhou
PageNumber	integer	Non	Le numéro de page de la liste. Valeur par défaut : 1.	1
PageSize	integer	Non	Le nombre d'entrées par page dans une requête paginée. Valeur par défaut : 10. Valeurs valides : 1 à 50.	10
IncludeReservationData	boolean	Non	Indique si les données de commande qui n'ont pas encore pris effet doivent être renvoyées. Valeurs valides : true : renvoie les données de commande qui n'ont pas encore pris effet. false (par défaut) : ne renvoie pas les données de commande qui n'ont pas encore pris effet.	false
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur de paramètre depuis votre client pour garantir l'unicité entre les différentes requêtes. ClientToken ne prend en charge que les caractères ASCII.	02fb3da4-130e-11e9-8e44-001
Filter	array<object>	Non	La liste des conditions de filtrage.
	object	Non	La condition de filtrage.
Key	string	Non	La condition de filtrage. Valeurs valides : PhysicalConnectionId : l'identifiant du circuit Express Connect. AccessPointId : l'identifiant du point d'accès. Type : le type de circuit Express Connect. Cette condition de filtrage ne prend en charge que la valeur de filtrage VPC. LineOperator : l'opérateur du circuit Express Connect. Cette condition de filtrage prend en charge les valeurs de filtrage suivantes : CT : China Telecom. CU : China Unicom. CM : China shift. CO : autres opérateurs en Chine continentale. Equinix : Equinix. Other : autres opérateurs en dehors de la Chine continentale. Spec : la spécification du circuit Express Connect. Cette condition de filtrage prend en charge les valeurs de filtrage suivantes : 1G and below. 10G. 40G. 100G. Remarque Les spécifications 40G et 100G ne sont pas disponibles par défaut. Seuls les utilisateurs qui ont soumis une demande à leur gestionnaire de compte et ont reçu une approbation peuvent utiliser ces valeurs de filtrage. Status : l'état du circuit Express Connect. Cette condition de filtrage prend en charge les valeurs de filtrage suivantes : Initial : en attente de demande. Approved : approuvé. Allocating : allocation des ressources en cours. Allocated : en cours de construction. Confirmed : en attente de confirmation de l'utilisateur. Enabled : activé. Rejected : demande rejetée. Canceled : annulé. Allocation Failed : échec de l'allocation des ressources. Terminating : arrêt en cours. Terminated : arrêté. Name : le nom du circuit Express Connect. ProductType : le type de circuit Express Connect. Valeurs valides : VirtualPhysicalConnection : circuit Express Connect partagé. PhysicalConnection : circuit Express Connect dédié. Vous pouvez spécifier jusqu'à 5 conditions de filtrage à la fois. Les conditions de filtrage ont une relation AND. Les résultats ne sont renvoyés que lorsque toutes les conditions de filtrage sont remplies.	Name
Value	array	Non	La liste des valeurs de filtrage.	1
	string	Non	La valeur de filtrage qui correspond à la condition de filtrage. Chaque condition de filtrage prend en charge jusqu'à 5 valeurs de filtrage. Plusieurs valeurs de filtrage ont une relation OR. Un enregistrement est considéré comme correspondant à la condition de filtrage s'il correspond à l'une des valeurs de filtrage.	nametest
Tags	array<object>	Non	La liste des balises.
	object	Non	La liste des balises.
Key	string	Non	La clé de balise de la ressource. Vous pouvez spécifier jusqu'à 20 clés de balise. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 64 caractères et peut contenir des chiffres, des points (.), des traits de soulignement (_) et des traits d'union (-). Elle ne peut pas commencer par `aliyun` ou `acs:`, et ne peut pas contenir `http://` ou `https://`.	FinanceDept
Value	string	Non	La valeur de balise de la ressource. Vous pouvez spécifier jusqu'à 20 valeurs de balise. La valeur de balise peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et peut contenir des chiffres, des points (.), des traits de soulignement (_) et des traits d'union (-). Elle ne peut pas commencer par `aliyun` ou `acs:`, et ne peut pas contenir `http://` ou `https://`.	FinanceJoshua
ResourceGroupId	string	Non	L'identifiant du groupe de ressources auquel le circuit Express Connect appartient.	rg-aek2yvwibxr****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	0E6D0EC4-7C91-53E2-9F65-64BF713114B0
PageNumber	integer	Le numéro de page de la liste. Valeur par défaut : 1.	1
PageSize	integer	Le nombre d'entrées par page dans une requête paginée. Valeur par défaut : 10. Valeurs valides : 1 à 50.	10
TotalCount	integer	Le nombre total d'entrées retournées.	1
PhysicalConnectionSet	object
PhysicalConnectionType	array<object>	La liste des circuits Express Connect.
	array<object>	Les détails du circuit Express Connect.
Type	string	Le type de circuit Express Connect. Valeurs valides : VPC.	VPC
Status	string	L'état du circuit Express Connect. Valeurs valides : Initial : La demande est en cours d'examen. Approved : La demande est approuvée. Allocating : Les ressources sont en cours d'allocation. Allocated : En cours de construction. Confirmed : En attente de confirmation de l'utilisateur. Enabled : Activé. Rejected : La demande est rejetée. Canceled : Annulé. Allocation Failed : L'allocation des ressources a échoué. Terminating : En cours de résiliation. Terminated : Résilié.	Enabled
CreationTime	string	L'heure de création du circuit Express Connect. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.	2021-08-24T07:30:58Z
AdLocation	string	L'emplacement de l'équipement d'accès du circuit Express Connect au niveau du point d'accès.	Ville de Hangzhou, province du Zhejiang, Chine
ReservationActiveTime	string	La période de validité de la commande en attente. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.	2022-02-25T11:01:04Z
ReservationOrderType	string	Le type de la commande en attente. Valeurs valides : RENEW, qui indique une commande de renouvellement.	RENEW
PortNumber	string	Le numéro de port de l'équipement d'accès du circuit Express Connect.	1/1/1
Spec	string	La spécification du circuit Express Connect. Unité : G indique Gbit/s.	10G
ChargeType	string	Le mode de facturation du circuit Express Connect. Valeurs valides : Prepaid, qui indique un abonnement.	Prepaid
ReservationInternetChargeType	string	Le mode de facturation de la commande en attente. Valeurs valides : PayByBandwidth, qui indique une facturation par bande passante.	PayByBandwidth
Description	string	La description du circuit Express Connect.	desctest
Bandwidth	integer	La bande passante du circuit Express Connect. Unité : Mbit/s.	10
EnabledTime	string	L'heure d'activation du circuit Express Connect. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.	2021-08-24T07:33:18Z
LineOperator	string	Le fournisseur de connectivité du circuit Express Connect. Valeurs valides : CT : China Telecom. CU : China Unicom. CM : China Mobile. CO : Autres fournisseurs de connectivité chinois. Equinix : Equinix. Other : Autres fournisseurs de connectivité en dehors de la Chine continentale.	CT
PeerLocation	string	L'emplacement géographique du centre de données local.	Ville de Hangzhou, province du Zhejiang, Chine
RedundantPhysicalConnectionId	string	L'identifiant du circuit Express Connect redondant.	pc-119mfjzm****
Name	string	Le nom du circuit Express Connect.	nametest
CircuitCode	string	Le code de circuit fourni par le fournisseur de connectivité pour le circuit Express Connect.	longtel001
EndTime	string	L'heure d'expiration du circuit Express Connect. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.	2022-04-24T16:00:00Z
PortType	string	Le type de port du circuit Express Connect. Valeurs valides : 100Base-T : Port Ethernet 100M. 1000Base-T : Port 1 GE. 1000Base-LX : Port optique monomode GE (10 km). 10GBase-T : Port 10 GE. 10GBase-LR : Port optique monomode 10 GE (10 km). 40GBase-LR : Port optique monomode 40 GE. 100GBase-LR : Port optique monomode 100 GE. Remarque Pour utiliser 40GBase-LR ou 100GBase-LR, vérifiez la disponibilité des ports auprès de votre gestionnaire de compte.	10GBase-LR
BusinessStatus	string	L'état commercial du circuit Express Connect. Valeurs valides : Normal : Activé. FinancialLocked : Verrouillé en raison d'un retard de paiement. SecurityLocked : Verrouillé pour des raisons de sécurité.	Normal
LoaStatus	string	L'état de la lettre d'autorisation (LOA). Valeurs valides : Applying : La demande de LOA est en cours de traitement. Accept : La demande de LOA est approuvée. Available : La LOA est disponible. Rejected : La demande de LOA est rejetée. Completing : Le circuit est en cours de construction. Complete : La construction du circuit est terminée. Deleted : La LOA est supprimée.	Available
AccessPointId	string	L'identifiant du point d'accès du circuit Express Connect.	ap-cn-hangzhou-finance-yh-E
AccessPointType	string	Le type de point d'accès du circuit Express Connect.	VPC
HasReservationData	string	Indique si le circuit Express Connect possède des données de commande en attente. Valeurs valides : true : Le circuit possède des données de commande en attente. false : Le circuit ne possède pas de données de commande en attente.	false
PhysicalConnectionId	string	L'identifiant d'instance du circuit Express Connect.	pc-bp1ciz7ekd2grn1as****
ProductType	string	Le type de circuit Express Connect. Valeurs valides : VirtualPhysicalConnection : Circuits Express Connect partagés. PhysicalConnection : Circuit Express Connect dédié.	PhysicalConnection
VirtualPhysicalConnectionCount	integer	Le nombre de circuits Express Connect partagés créés sur le circuit Express Connect actuel.	0
ParentPhysicalConnectionId	string	L'identifiant d'instance du circuit Express Connect associé aux circuits Express Connect partagés.	pc-bp1ciz7ekd2grn1as****
ParentPhysicalConnectionAliUid	integer	L'identifiant de compte Alibaba Cloud du propriétaire du circuit Express Connect associé aux circuits Express Connect partagés.	132193271328****
VlanId	string	L'identifiant VLAN des circuits Express Connect partagés.	10
OrderMode	string	Le payeur des circuits Express Connect partagés. Valeurs valides : PayByPhysicalConnectionOwner : Le partenaire est le payeur. PayByVirtualPhysicalConnectionOwner : Le locataire est le payeur.	PayByPhysicalConnectionOwner
VpconnStatus	string	L'état commercial des circuits Express Connect partagés. Valeurs valides : Confirmed : Les circuits Express Connect partagés sont acceptés. UnConfirmed : Les circuits Express Connect partagés ne sont pas acceptés. Deleted : Les circuits Express Connect partagés sont supprimés.	Confirmed
ExpectSpec	string	La bande passante attendue des circuits Express Connect partagés. La bande passante attendue prend effet une fois le paiement effectué. Unité : M indique Mbit/s, G indique Gbit/s.	50M
ResourceGroupId	string	L'identifiant du groupe de ressources.	rg-acfmwu3k52p****
AdDetailLocation	string	Les informations concernant le centre de données et la baie.	Ville de Hangzhou, province du Zhejiang, centre de données XX, salle ET135ET135-XX-2, baie JXX, position 30
Tags	object
tags	array<object>	La liste des balises.
	object	La liste des balises.
Key	string	La clé de balise de la ressource. Vous pouvez spécifier jusqu'à 20 clés de balise. La clé de balise ne peut pas être une chaîne vide. La clé de balise peut comporter jusqu'à 64 caractères et peut contenir des chiffres, des points (.), des traits de soulignement (_) et des traits d'union (-). Elle ne peut pas commencer par `aliyun` ou `acs:`, et ne peut pas contenir `http://` ou `https://`.	FinanceDept
Value	string	La valeur de balise de la ressource. Vous pouvez spécifier jusqu'à 20 valeurs de balise. La valeur de balise peut être une chaîne vide. La valeur de balise peut comporter jusqu'à 128 caractères et peut contenir des chiffres, des points (.), des traits de soulignement (_) et des traits d'union (-). Elle ne peut pas commencer par `aliyun` ou `acs:`, et ne peut pas contenir `http://` ou `https://`.	FinanceJoshua
QosId	string	L'identifiant d'instance de la stratégie QoS.	qos-bp10s3szn8rgnxuw7****
OpticalModuleModel	string	Le modèle de module optique saisi par l'utilisateur.	SFP-GE-LR-SM1310,10KM
MacsecKeys	object
MacsecKey	array<object>	La liste des informations de clé MACSec pour le circuit Express Connect.
	object	Les informations de clé MACSec pour le circuit Express Connect.
CipherSuite	string	La suite de chiffrement MACSec. Valeurs valides : ● GCM-AES-128 ● GCM-AES-XPN-128 ● GCM-AES-256 ● GCM-AES-XPN-256	GCM-AES-128
Ckn	string	Le nom de la clé.	0123456789ABCDEF0123456789ABCDEF
Cak	string	Le secret de la clé.	0123456789ABCDEF0123456789ABCDEF
StartOn	string	L'heure de création de la clé. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.	2026-04-13T00:00:00Z
Status	string	L'état de la clé. Valeurs valides : ● Associating : En cours d'association. ● Associated : Associée. ● AssociatedFailed : Échec de l'association. ● Disassociating : En cours de dissociation. ● Disassociated : Dissociée.	Associated
DownDelayTime	integer	Le délai d'arrêt du port du circuit Express Connect, en millisecondes. Lorsqu'un événement d'arrêt de liaison physique est détecté, l'équipement d'accès attend cette durée avant de définir l'état du port sur arrêté. Cela empêche les déconnexions transitoires d'affecter les services. Valeurs valides : 0 à 10000. Le pas est de 100. Une valeur de 0 indique que le port s'arrête immédiatement après l'arrêt de la liaison (par défaut). Vous pouvez modifier cette valeur en appelant l'opération ModifyPhysicalConnectionAttribute.	100
DeviceFeaturesSelected	string	La liste des fonctionnalités avancées sélectionnées pour l'équipement d'accès du circuit Express Connect. Les fonctionnalités multiples sont séparées par des virgules (,).	BFD,MACSec,LinkDelay

Exemples

JSON format

{
  "RequestId": "0E6D0EC4-7C91-53E2-9F65-64BF713114B0",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "PhysicalConnectionSet": {
    "PhysicalConnectionType": [
      {
        "Type": "VPC",
        "Status": "Enabled",
        "CreationTime": "2021-08-24T07:30:58Z",
        "AdLocation": "Hangzhou City, Zhejiang Province, China",
        "ReservationActiveTime": "2022-02-25T11:01:04Z",
        "ReservationOrderType": "RENEW",
        "PortNumber": "1/1/1",
        "Spec": "10G",
        "ChargeType": "Prepaid",
        "ReservationInternetChargeType": "PayByBandwidth",
        "Description": "desctest",
        "Bandwidth": 10,
        "EnabledTime": "2021-08-24T07:33:18Z",
        "LineOperator": "CT",
        "PeerLocation": "Hangzhou City, Zhejiang Province, China",
        "RedundantPhysicalConnectionId": "pc-119mfjzm****",
        "Name": "nametest",
        "CircuitCode": "longtel001",
        "EndTime": "2022-04-24T16:00:00Z",
        "PortType": "10GBase-LR",
        "BusinessStatus": "Normal",
        "LoaStatus": "Available",
        "AccessPointId": "ap-cn-hangzhou-finance-yh-E",
        "AccessPointType": "VPC",
        "HasReservationData": "false",
        "PhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
        "ProductType": "PhysicalConnection",
        "VirtualPhysicalConnectionCount": 0,
        "ParentPhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
        "ParentPhysicalConnectionAliUid": 0,
        "VlanId": "10",
        "OrderMode": "PayByPhysicalConnectionOwner",
        "VpconnStatus": "Confirmed",
        "ExpectSpec": "50M",
        "ResourceGroupId": "rg-acfmwu3k52p****",
        "AdDetailLocation": "Hangzhou City, Zhejiang Province, XX Data Center, ET135ET135-XX-2 Room, JXX Rack, position30",
        "Tags": {
          "tags": [
            {
              "Key": "FinanceDept",
              "Value": "FinanceJoshua"
            }
          ]
        },
        "QosId": "qos-bp10s3szn8rgnxuw7****",
        "OpticalModuleModel": "SFP-GE-LR-SM1310,10KM",
        "MacsecKeys": {
          "MacsecKey": [
            {
              "CipherSuite": "GCM-AES-128",
              "Ckn": "0123456789ABCDEF0123456789ABCDEF",
              "Cak": "0123456789ABCDEF0123456789ABCDEF",
              "StartOn": "2026-04-13T00:00:00Z",
              "Status": "Associated"
            }
          ]
        },
        "DownDelayTime": 100,
        "DeviceFeaturesSelected": "BFD,MACSec,LinkDelay"
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	OperationUnsupported.ResourceGroupId	ResourceGroupId in financial region is unsupported.	L'opération n'est pas prise en charge. Les identifiants de groupe de ressources ne sont pas pris en charge dans Finance Cloud.
400	InvalidTagKey.Malformed	The specified tag key is invalid.	La clé de balise n'est pas valide. Spécifiez une clé de balise valide et réessayez.
400	OperationFailed.InternalError	The request processing has failed due to some unknown error.	Une erreur inconnue s'est produite. Réessayez l'opération. Si l'erreur persiste, soumettez un ticket.
404	InvalidFilterKey.ValueNotSupported	Specified filter key is not supported: Filter.X.key	La clé du filtre n'est pas prise en charge : Filter.X.key.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.