API de statistiques portuaires (DÉPRÉCIÉE)

Conditions préalables

Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour OAuth2 Authentification. Consultez Authentification API pour obtenir des instructions sur la façon d'appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.

Obtenir les statistiques d'un port spécifié

Pour obtenir les statistiques d'utilisation de la bande passante du port, envoyez une requête GET au point de terminaison /fabric/v4/ports/{uuid}/stats. Spécifiez l'identifiant du port dans le chemin de la requête. Indiquez la période pour laquelle les statistiques sont recherchées en tant que paramètres de requête, en utilisant des horodatages au format ISO 8601.

Method	GET
URL or Endpoint	/fabric/v4/ports/{uuid}/stats
Headers	Authorization, Content-Type
Path Parameters	uuid
Query Parameters	startDateTime, endDateTime
Body Parameters	Not applicable

Exemple de requête cURL:

curl -X GET 'https://api.equinix.com/fabric/v4/ports/{port_id}/stats?startDateTime=2021-01-07T19:26:22Z&endDateTime=2021-01-26T19:55:22Z'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'

Exemple de réponse:

{  
    "type": "XF_PORT",  
    "uuid": "xxxxx191-xx70-xxxx-xx04-xxxxxxxa37xx",  
    "name": "Equinix-EM-CX-xxx-L-Dot1q-BO-100G-PRI-xx",  
  
    "bandwidth": 10000,  
    "stats": {  
        "startDateTime": "2021-02-24T16:00:00Z",  
        "endDateTime": "2021-02-25T23:59:44Z",  
        "bandwidthUtilization": {  
        "unit": "Mbps",  
        "metricInterval": "PT5M",  
        "inbound": {  
            "max": 36.46022222224523,  
            "mean": 12.681258259259257,  
            "lastPolled": 24.67873548,  
            "metrics": [  
            {  
                "intervalEndDateTime": "2021-02-24T16:00:00Z",  
                "max": 24.197777777777777,  
                "mean": 9.460203703703565  
            },  
            {  
                "intervalEndDateTime": "2021-02-24T16:05:00Z",  
                "max": 29.237066666666667,  
                "mean": 11.487487592592595  
            },  
            {  
                "intervalEndDateTime": "2021-02-24T16:10:00Z",  
                "max": 31.2726757889999,  
                "mean": 11.77661203703704  
            },  
            {  
                "intervalEndDateTime": "2021-03-04T16:15:00Z",  
                "max": 28.179666666666666,  
                "mean": 7.414631481481509  
            },  
            {  
                "intervalEndDateTime": "2021-03-15T16:20:00Z",  
                "max": 29.29311111111111,  
                "mean": 6.247431481481508  
            }  
            ]  
        },  
        "outbound": {  
            "max": 60.33548888888889,  
            "mean": 41.22711543985719,  
            "lastPolled": 55.14977777777778,  
            "metrics": [  
            {  
                "intervalEndDateTime": "2021-02-24T16:00:00Z",  
                "max": 53.790333333333336,  
                "mean": 39.80057592592591  
            },  
            {  
                "intervalEndDateTime": "2021-02-24T16:05:00Z",  
                "max": 57.353,  
                "mean": 38.678568800295  
            },  
            {  
                "intervalEndDateTime": "2021-02-24T16:10:00Z",  
                "max": 59.32777777777778,  
                "mean": 35.08689444444445  
            },  
            {  
                "intervalEndDateTime": "2021-02-24T16:15:00Z",  
                "max": 537274933333333300,  
                "mean": 23.855259259259284  
            },  
            {  
                "intervalEndDateTime": "2021-02-24T16:20:00Z",  
                "max": 57.75604444444444,  
                "mean": 41.36731129629629  
            }  
            ]  
        }  
        }  
    }  
}

Pour des descriptions détaillées des champs de réponse, consultez la Référence API.