Skip to main content

Approve or Reject a Connection Request

Prerequisites

  1. Authenticate - Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication. Refer to API Authentication for instructions on how to call OAuth API to validate and authenticate your credentials.

  2. Find the pending connection's ID. Use the Search Connections endpoint to get a list of pending connections, and identify the one you want to approve or reject.

  3. Determine Z-side port information. Get your Equinix Fabric ports' information using the Get All Ports endpoint.

Approve a Connection

To approve a connection, send a POST request to the /fabric/v4/connections/{uuid}/actions endpoint. Specify CONNECTION_CREATION_ACCEPTANCE for the type parameter and the z-side port information to the data parameter in the body of the request. Approving the connection also creates it.

POST /fabric/v4/connections/{uuid}/actions
MethodPOST
URL or Endpoint/fabric/v4/connections/{uuid}/actions
HeadersAuthorization, Content-Type
Path Parametersuuid
Query ParametersNot applicable
Body Parameterstype, data, description

Sample cURL Request:

curl -X  
POST 'https: //api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62/actions'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "type": "CONNECTION_CREATION_ACCEPTANCE",
    "data": {
        "zSide": {
            "accessPoint": {
                "type": "COLO",
                "port": {
                    "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
                },
                "linkProtocol": {
                    "type": "QINQ",
                    "vlanSTag": 1002,
                    "vlanCTag": 1001
                }
            }
        }
    }
}'

Sample Response:

{  
    "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",
    "type": "EVPL_VC",
    "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",
    "state": "PROVISIONED",
    "name": "Conn-Name-2",
    "order": {
        "purchaseOrderNumber": "1-129105284100",
        "billingTier": "Up to 1 Gbps"
    },
    "bandwidth": 1000,
    "change": {
        "uuid": "da6a1a0b-0872-4c06-b9d7-5c8ee3056775",
        "type": "CONNECTION_CREATION",
        "status": "APPROVED",
        "createdDateTime": "2021-12-12T06:00:01.183Z",
    },
    "redundancy": {
        "group": "m167f685-41b0-1b07-6de0-320a5c00abeu",
        "priority": "PRIMARY"
    },
    "aSide": {
        "accessPoint": {
            "type": "COLO",
            "port": {
                "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",
                "type": "XF_PORT",
                "uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
            },
            "linkProtocol": {
                "type": "DOT1Q",
                "vlanTag": 1001
            }
        }
    },
    "zSide": {
        "accessPoint": {
            "type": "SP",
            "profile": {
                "href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",
                "type": "L2_Profile",
                "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
            },
            "location": {
                "href": "https://api.equinix.com/v4/metros/SV",
                "metrocode": "SV",
                "region": "AMER"
            },
            "port": {
                "href": "https://api.equinix.com/fabric/v4/ports/c791f8cb-5ae1-ae10-8ce0-306a5c00a4ee",
                "uuid": "c791f8cb-5ae1-ae10-8ce0-306a5c00a4ee",
                "name": "testBuyer-FR4-L-Dot1q-STD-PRI-10G-JN-489"
            },
            "linkProtocol": {
                "type": "DOT1Q",
                "vlanTag": 837
            }
        }
    },
    "notifications": [
        {
            "type": "ALL",
            "emails": [
                "test@equinix.com",
                "test@equinix.com"
            ]
        }
    ],
    "operation": {
        "equinixStatus": "PROVISIONED",
        "providerStatus": "PROVISIONED"
    },
    "changeLog": {
        "createdDateTime": "2021-07-15T19:30:29.526Z",
        "updatedDateTime": "2021-08-15T19:30:29.526Z",
    }
}

Reject a Connection

To reject a connection, send a POST request to the /fabric/v4/connections/{uuid}/actions endpoint. Specify CONNECTION_CREATION_REJECTION for the type parameter a in the body of the request.

Sample cURL Request:

curl -X  
POST 'https: //api.equinix.com/fabric/v4/connections/{connection_id}/actions'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "type": "CONNECTION_CREATION_REJECTION",
    "description": "Invalid connection update request"
}'