Get All Metros - Parameters Mapping

This API returns a data set with all available metros.

v3 request

curl -X
GET 'https://api.equinix.com/ecx/v3/l2/common/metros'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'

v4 request

curl -X
GET 'https://api.equinix.com/fabric/v4/metros'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'

v3 API request	v4 API request	Description
GET /ecx/v3/l2/metros	GET /fabric/v4/metros	Request: - Response: v3 and v4 metro objects have different structure and parameters' names.

Response

v3 request

[
    {
        "name": "Amsterdam",
        "code": "AM",
        "region": "EMEA",
        "cloudReach": [
            "LD",
            "FR",
            "PA",
            "DB",
            "SK",
            "ZH",
            "HE",
            "ML",
            "WA",
            "MD"
        ]
    }
]

v4 request

{
    "pagination": {
        "offset": 0,
        "limit": 49,
        "total": 49
    },
    "data": [
        {
            "href": "http://api.equinix.com/fabric/v4/metros/AM",
            "type": "XF_METRO",
            "code": "AM",
            "region": "EMEA",
            "name": "Amsterdam",
            "connectedMetros": [
                {
                    "href": "http://api.equinix.com/fabric/v4/metros/AT",
                    "code": "AT",
                    "avgLatency": 95.8
                },
                {
                    "href": "http://api.equinix.com/fabric/v4/metros/BA",
                    "code": "BA",
                    "avgLatency": 31.6
                }
            ]
        }
    ]
}

v3 parameter	v4 parameter	Example	Description
-	pagination	-	New container object for pagination parameters.
-	pagination.offset	200	New parameter specifying the results page offset.
-	pagination.limit	100	New parameter specifying the number of items returned on a single page.
-	pagination.total	1000	New parameter specifying the total number of objects in the data set.
-	href	http://api.equinix.com/fabric/v4/metros/AM	New parameter specifying the absolute URL that returns details of the given asset.
-	type	XF_METRO	New parameter specifying metro type.
code	code	AM	Metropolitan area identifier.
region	region	EMEA	Broad geographic area in which a specified Equinix asset is located.
name	name	Amsterdam	Metropolitan area name.
cloudReach	-	-	List of metros accessible from the given metro. This parameter has been replaced with the connectedMetros objects array providing additional information on average connection latency.
-	connectedMetros	-	New container object for connected metros.
-	href	http://api.equinix.com/fabric/v4/metros/AT	New parameter specifying the absolute URL that returns details of the given asset.
-	code	AT	Metropolitan area identifier of the connected metro.
-	avgLatency	95.8	New parameter specifying an average connection latency to the given metro.