Create Cross Connect

Prerequisite: Only contract administrators, owners, and users with createPcc privilege can create and manage Cross Connects via the API. You can also set User privileges in the DCD. For more information, see Set User Privileges for Cross Connect.

Note: To connect a LAN to a Cross Connect, you must use the /lan endpoint. For more information about how to create LANs and associate them with a Cross Connect, see Associate Cross Connect with the VDC.

To create a Cross Connect via the API, perform a POST request with the name and description of the Cross Connect.

Request

   curl --location \
   --request POST 'https://api.ionos.com/cloudapi/v6/pccs' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Basic <auth-token>' \
   --data '{
            "properties": 
            {
             "name": "CrossConnect-Berlin",
             "description": "Cross Connect between datacenter '\''Berlin-W1'\'' and datacenter '\''Berlin-W2'\'' "
            }
           }'

Response

202 Successful operation

{
    "id": "f7a9c1-815a-486f-bb7b-3d0f2",
    "type": "pcc",
    "href": "https://api.ionos.com/cloudapi/v6/pccs/f7a9c1-815a-486f-bb7b-3d0f2",
    "metadata": {
        "createdDate": "2023-09-18T12:02:16Z",
        "createdBy": "[email protected]",
        "etag": "5409657baffecf",
        "lastModifiedDate": "2023-09-18T12:02:16Z",
        "lastModifiedBy": "[email protected]",
        "state": "BUSY"
    },
    "properties": {
        "name": "CrossConnect-Berlin",
        "description": "Cross Connect between datacenter 'Berlin-W1' and datacenter 'Berlin-W2' ",
        "peers": [],
        "connectableDatacenters": []
    }
}

For more information about the request and response fields, see Create a Cross Connect.