Update a 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.

To modify a Cross Connect via the API, perform a PATCH request with the ID of the respective Cross Connect.

Request

   curl --location 
   --request PATCH 'https://api.ionos.com/cloudapi/v6/pccs/b229-d5df-4b97-bb23-e8b3' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Basic <auth-token>' \
   --data ' {
        "name": "My resource1",
        "description": "Cross Connect between datacenter '\''E'\'' and datacenter '\''B'\'' "
}
'

Response

202 Successful operation

{
    "id": "b229-d5df-4b97-bb23-e8b3",
    "type": "pcc",
    "href": "https://api.ionos.com/cloudapi/v6/pccs/b229-d5df-4b97-bb23-e8b3",
    "metadata": {
        "createdDate": "2023-10-11T13:29:16Z",
        "createdBy": "[e-mail]",
        "etag": "9913a87deffc",
        "lastModifiedDate": "2023-10-12T06:06:36Z",
        "lastModifiedBy": "[e-mail]",
        "state": "BUSY"
    },
    "properties": {
        "name": "My resource1",
        "description": "Cross Connect between datacenter 'E' and datacenter 'B' ",
        "peers": [],
        "connectableDatacenters": [
            {
                "id": "40ea-d887-4819-809b-41c6",
                "name": "Berlin-W1",
                "location": "de/txl"
            },
            {
                "id": "1ee4-7065-51ad-8yd6-cecf",
                "name": "VMAS",
                "location": "de/txl"
            },
            {
                "id": "12v2-7a56-4228-8990-b9fa",
                "name": "Berlin-W2",
                "location": "de/txl"
            }
        ]
    }
}

For more information about the request and response fields, see Partially modify Cross Connects.