Skip to main content
Index

Update Bandwidth/Speed of a Connection

Step 1: Authenticate

Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication.

 

Refer to Generating a Client ID and Client Secret key under Getting Started section for instructions on how to create client ID and client secret and refer to Requesting Access and Refresh tokens for instructions on how to call OAuth API to validate and authenticate your credentials.

 

If you are unaware of your user credentials for Equinix Fabric, contact your local Equinix Service Desk. 

Step 2: Update bandwidth/speed

Update the speed of the connection using the below API.

 

PATCH /connections/{uuid}

 Method  PATCH
 URL or End Point

 /ecx/v3/l2/connections/{uuid}

 Headers  Authorization, Content-Type
 Query Parameters  action
 Body  speed, speedUnit

 

The connection speed can only be updated for Microsoft Azure, Oracle FastConnect, Google, and Enterprise connections.

 

Uuid is an identifier unique to each connection.

 

If you are unaware of how to obtain an authorization key, refer to Requesting Access and Refresh tokens under the Getting Started section.

 

The following screenshots show a sample curl request and JSON response to update the speed of a connection with UUID 9999a8-0e07-44d0-944c-88a25d8d28f7

 

curl -X

PATCH "https://api.equinix.com/ecx/v3/l2/connections/9999a8-0e07-44d0-944c-88a25d8d28f7?action=update"

-H "content-type: application/json"

-H "Authorization: Bearer qwErtY8zyW1abcdefGHI"

-d '{

"speed":50,

"speedUnit":"MB"

}'

 

The description of the request payload is as follows:

 

URL Parameter Name Mandatory Type Example Applicable Values Description
UUID Yes string 9999a8-0e07-44d0-944c-88a25d8d28f7   The Equinix-assigned ID of the connection.

 

Query Parameter Name Mandatory Type Example Applicable Values Description
action Yes string Update

"Approve"

"Reject"

"Update"

The action to perform on the connection.

 

Body Parameter Name Mandatory Type Example Description
speed Yes integer 50 Speed/Bandwidth you would like to allocate to the connection
speedUnit Yes string MB Unit of the speed or bandwidth.

 

{
    "message": "Connection updated Successfully",
    "primaryConnectionId": "9999a8-0e07-44d0-944c-88a25d8d28f7",

    "status": "submitted"
}

 

The description of the response payload is as follows:

 

Field Name Type Example values Description
message string Connection updated Successfully Indicates the status of the PATCH API call.
primaryConnectionID string 9999a8-0e07-44d0-944c-88a25d8d28f7 Indicates the primary connection ID.

 

If you get “Access Denied” error, contact your local Equinix Service Desk for Equinix Fabric Portal access.

 

In order for the speed to be updated, your seller must accept this request and make the relevant changes at the sellers' end. Once this is done, you can verify the speed using the API GET Connections{uuid}