Skip to main content

Validate Connection Authorization Key - Parameters Mapping

This API request validates authorization key used for authorizing connections to third-parties based on service profiles.

v3 request
curl -X
GET 'https://api.equinix.com/ecx/v3/l2/connections/validateAuthorizationKey?authorizationKey=991040a8-2e08-48b9-b0f8-8c5f87dfbx6a&metroCode=DC&profileId=x1384t22-bbe0-4e43-ax37-95beeg9d254d&region=AMER'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
v4 request
curl -X POST 'http://api.equinix.com/fabric/v4/connections/validate'
-H 'content-type: application/json'
-H 'authorization: Bearer qwErtY8zyW1abcdefGHI'
-d '{
"filter": {
"and": [
{
"property": "/zSide/accessPoint/authenticationKey",
"operator": "=",
"values": [
"xx-xx-xx"
]
},
{
"property": "/zSide/accessPoint/profile/uuid",
"operator": "=",
"values": [
"20d32a80-0d61-4333-bc03-707b591ae2f5"
]
},
{
"property": "/zSide/accessPoint/sellerRegion",
"operator": "=",
"values": [
"us-west1"
]
}
]
}
}'

v3 API requestv4 API requestDescription
GET /ecx/v3/l2/connections/validateAuthorizationKeyPOST /fabric/v4/connection/validateRequest: v3 and v4 use different HTTP methods. In v3 the value of the authorization key is provided as a query parameter while in the v4 it's specified in the request body.

Response: The response payload is different due to changes in the connection object.
 
v3 parameterv4 parameterExampleDescription
authorizationKey/zSide/accessPoint/authenticationKey{
    "property": "/zSide/accessPoint/authenticationKey",
    "operator": "=",
    "values": [
        "xx-xx-xx"
    ]
}
Parameters in v4 API are defined in the request payload body.
metroCode-- 
profileId/zSide/accessPoint/profile/uuid{
    "property": "/zSide/accessPoint/profile/uuid",
    "operator": "=",
    "values": [
        "20d32a80-0d61-4333-bc03-707b591ae2f5"
    ]
}
Parameters in v4 API are defined in the request payload body.
region/zSide/accessPoint/sellerRegion{
    "property": "/zSide/accessPoint/sellerRegion",
    "operator": "=",
    "values": [
        "us-west1"
    ]
}
Parameters in v4 API are defined in the request payload body.