Update Connection Bandwidth

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 the OAuth API to validate and authenticate your credentials.

Updating the Connection

To update a connection's bandwidth, send a PATCH request to the /fabric/v4/connections/{id} endpoint.

	PATCH /fabric/v4/connections/{uuid}
Method	PATCH
URL or Endpoint	/fabric/v4/connections/{uuid}
Headers	Authorization, Content-Type
Path Parameters	uuid
Query Parameters	Not applicable
Body Parameters	op, path, value

To safely validate this request in production without changing any connection bandwidth, see Testing in Production (API Dry Run).

Sample cURL Request:

curl -X  
PATCH 'https: //api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[  
    {  
        "op": "replace",  
        "path": "/bandwidth",  
        "value": 1000  
    }  
]'

Path parameters

Parameter	Mandatory	Type	Example values	Applicable values	Description
uuid	yes	string	3a58dd05-f46d-4b1d-a154-2e85c396ea62	-	Equinix-assigned connection identifier.

Body parameters

Parameter	Mandatory	Type	Example values	Applicable values	Description
op	yes	string	replace	replace	Update request type.
path	yes	string	/name	/bandwidth	Parameter path.
value	yes	string integer	Conn-Name-2	-	Parameter value.
/bandwidth
value	yes	integer	1000	10 50 200 500 1000 2000 5000 10000	Connection bandwidth in Mbps.

Sample Response:

{  
    "href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",  
    "type": "EVPL_VC",  
    "uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",  
    "name": "Conn-Name-2",  
    "state": "PROVISIONED",  
    "order": {  
        "purchaseOrderNumber": "1-129105284100",  
        "billingTier": "Up to 1 Gbps"  
    },  
    "bandwidth": 1000,  
    "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"  
            }  
        }  
    },  
    "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",  
    }  
}