List Dedicated Circuit Service Providers

 

Updated: July 10, 2015

The List Dedicated Circuit Service Providers operation lists the dedicated circuit service providers that are available to choose from for setting up network connectivity.

The List Dedicated Circuit Service Providers request may be specified as follows. Replace <subscription-id> with the subscription ID.

Method

Request URI

GET

https://management.core.windows.net/<subscription-id>/services/networking/dedicatedcircuits/serviceproviders

You must make sure that the request that is made to the management service is secure. For additional details, see Authenticating Service Management Requests.

The following table describes the request headers.

Request Header

Description

x-ms-version

Required. Specifies the version of the operation to use for this request. This header should be set to 2014-01-01 or higher. For more information about versioning headers, see Service Management Versioning.

The response includes an HTTP status code, a set of response headers, and a response body.

A successful operation returns status code 200 (OK). For information about status codes, see Service Management Status and Error Codes.

The response for this operation includes the following headers. The response may also include additional standard HTTP headers. All standard headers comply with the HTTP/1.1 protocol specification.

Response Header

Description

x-ms-request-id

A value that uniquely identifies a request made against the management service.

The following example shows the format of the response body:

Copy 

<?xml version="1.0" encoding="utf-8"?>
<DedicatedCircuitServiceProviders xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <DedicatedCircuitServiceProvider>
    <Name>name-of-provider</Name>
    <Type>type-of-provided-service</Type>
    <DedicatedCircuitLocations>available-locations</DedicatedCircuitLocations>
    <DedicatedCircuitBandwidths>
      <DedicatedCircuitBandwidth>
        <Bandwidth>bandwidth-of-circuit</Bandwidth>
        <Label>label-of-circuit</Label>
      <DedicatedCircuitBandwidth>
    </DedicatedCircuitBandwidths>
  <DedicatedCircuitServiceProvider>
</DedicatedCircuitServiceProviders>

The following table describes the elements of the response body.

Element name

Description

DedicatedCircuitServiceProvider

Specifies the information that can be used to identify an appropriate dedicated circuit service provider.

Name

Specifies the name of the dedicated circuit service provider.

Type

Specifies the type of service that is offered by the dedicated circuit service provider.

Possible values are:

  • IXP

  • Telco

DedicatedCircuitLocations

Specifies the locations in which the dedicated circuit service provider can peer.

DedicatedCircuitBandwidths

Specifies the bandwidth information that is available from the dedicated circuit service provider.

Specifies the bandwidth information that is available from the dedicated circuit service provider.

Element name

Description

Bandwidth

Specifies the bandwidth that is available from the dedicated circuit service provider.

Label

Specifies the label of the available circuit.

To create a dedicated circuit, see Create Dedicated Circuit.

Show: