# Network › OVHcloud Connect › Configuration API

> Part of the OVHcloud developer hub. Index of every page and section: https://developers.eu.ovhcloud.com/llms.txt
> The Network product's sections: https://developers.eu.ovhcloud.com/reference/network/llms.txt
> Everything in one file: https://developers.eu.ovhcloud.com/llms-full.txt

> 14 operations of the OVHcloud API. Calls carry `authorization: Bearer $OVH_TOKEN`; the EU host is shown, Canada and the United States answer on api.ca.ovhcloud.com and api.us.ovhcloud.com.

Page: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/

OpenAPI v1: https://api.eu.ovhcloud.com/1.0/__schemas/developer-hub-navigation/network/ovhcloud-connect/configuration.json?format=openapi3
OpenAPI v2: https://api.eu.ovhcloud.com/v2/__schemas/developer-hub-navigation/network/ovhcloud-connect/configuration.json?format=openapi3

## Operations

- `GET /ovhCloudConnect/{serviceName}/config/pop` — List PoP configurations
- `GET /ovhCloudConnect/{serviceName}/datacenter` — List availability zones
- `GET /ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter` — List availability zone configurations
- `GET /ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra` — List routing configurations
- `GET /ovhCloudConnect/{serviceName}/config/pop/{popId}` — Get PoP configuration
- `GET /ovhCloudConnect/{serviceName}/datacenter/{id}` — Get availability zone
- `GET /ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}` — Get availability zone configuration
- `GET /ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}` — Get routing configuration
- `POST /ovhCloudConnect/{serviceName}/config/pop` — Create PoP configuration
- `POST /ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter` — Create availability zone configuration
- `POST /ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra` — Create routing configuration
- `DELETE /ovhCloudConnect/{serviceName}/config/pop/{popId}` — Delete PoP configuration
- `DELETE /ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}` — Delete availability zone configuration
- `DELETE /ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}` — Delete routing configuration

## List PoP configurations

`GET /1.0/ovhCloudConnect/{serviceName}/config/pop`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#get-ovhcloudconnect-servicename-config-pop

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/get`

Returns the IDs of the PoP configurations.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | integer[] | successful operation |

```json
[
  0
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/ovhCloudConnect/{serviceName}/config/pop")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/ovhCloudConnect/{serviceName}/config/pop");

print_r($result);
?>
```

## List availability zones

`GET /1.0/ovhCloudConnect/{serviceName}/datacenter`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#get-ovhcloudconnect-servicename-datacenter

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:datacenter/get`

Returns the IDs of the availability zones this service can connect to.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | integer[] | successful operation |

```json
[
  0
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/datacenter" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/ovhCloudConnect/{serviceName}/datacenter")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/ovhCloudConnect/{serviceName}/datacenter");

print_r($result);
?>
```

## List availability zone configurations

`GET /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#get-ovhcloudconnect-servicename-config-pop-popid-datacenter

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/datacenter/get`

Returns the IDs of the availability zones connected through this PoP configuration.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | integer[] | successful operation |

```json
[
  0
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter");

print_r($result);
?>
```

## List routing configurations

`GET /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#get-ovhcloudconnect-servicename-config-pop-popid-datacenter-datacenterid-extra

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/datacenter/extra/get`

Returns the IDs of the BGP peers and static routes of this availability zone configuration.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `datacenterId` | path | integer | yes | Datacenter ID |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | integer[] | successful operation |

```json
[
  0
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra");

print_r($result);
?>
```

## Get PoP configuration

`GET /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#get-ovhcloudconnect-servicename-config-pop-popid

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/get`

Returns the configuration's type, interface, subnet, AS numbers and status.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.PopConfig | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `customerBgpArea` | integer |  | Customer Private AS |
| `id` | integer | read-only | ID of the Pop Configuration |
| `interfaceId` | integer | yes | ID of the interface |
| `ovhBgpArea` | integer |  | OVH Private AS |
| `status` | ovhcloudconnect.popConfig.StatusEnum | read-only | Status of the pop configuration — one of `active`, `init`, `toDelete` |
| `subnet` | ipv4Block |  | Subnet should be a /30, first IP for OVH, second IP for customer |
| `type` | ovhcloudconnect.popConfig.TypeEnum | yes | Type of the pop configuration — one of `l2`, `l3` |

```json
{
  "customerBgpArea": 0,
  "id": 0,
  "interfaceId": 0,
  "ovhBgpArea": 0,
  "status": "active",
  "subnet": "192.0.2.0/24",
  "type": "l2"
}
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/ovhCloudConnect/{serviceName}/config/pop/{popId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/ovhCloudConnect/{serviceName}/config/pop/{popId}");

print_r($result);
?>
```

## Get availability zone

`GET /1.0/ovhCloudConnect/{serviceName}/datacenter/{id}`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#get-ovhcloudconnect-servicename-datacenter-id

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:datacenter/get`

Returns the availability zone's name, region, 1-AZ or 3-AZ type, and whether it accepts a new configuration.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | integer | yes | Id |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.Datacenter | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `available` | boolean | read-only | Get availability to add new configuration on it |
| `id` | integer | read-only | ID of the datacenter |
| `name` | string | read-only | name of the datacenter |
| `region` | common.RegionEnum | read-only | region of the datacenter — one of `af-north-lz-rba`, `ap-south-mum`, `ap-southeast-sgp`, `ap-southeast-syd`, `ca-east-bhs`, `ca-east-tor`, `eu-central-lz-buh`, `eu-central-lz-prg`, `eu-central-lz-sof`, `eu-central-waw`, `eu-north-lz-cph`, `eu-north-lz-hel`, … |
| `regionType` | ovhcloudconnect.datacenter.RegionTypeEnum | read-only | region type of the datacenter — one of `1-AZ`, `3-AZ` |

```json
{
  "available": true,
  "id": 0,
  "name": "string",
  "region": "af-north-lz-rba",
  "regionType": "1-AZ"
}
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/datacenter/{id}" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/ovhCloudConnect/{serviceName}/datacenter/{id}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/ovhCloudConnect/{serviceName}/datacenter/{id}");

print_r($result);
?>
```

## Get availability zone configuration

`GET /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#get-ovhcloudconnect-servicename-config-pop-popid-datacenter-datacenterid

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/datacenter/get`

Returns the linked availability zone, subnet, OVHcloud AS and status.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `datacenterId` | path | integer | yes | Datacenter ID |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.DatacenterConfig | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `datacenterId` | integer | yes | ID of the datacenter linked |
| `id` | integer | read-only | ID of the Datacenter configuration |
| `ovhBgpArea` | integer |  | OVH Private AS |
| `status` | ovhcloudconnect.popConfig.StatusEnum | read-only | Status of the pop configuration — one of `active`, `init`, `toDelete` |
| `subnet` | ipv4Block |  | Subnet should be a /28 min |

```json
{
  "datacenterId": 0,
  "id": 0,
  "ovhBgpArea": 0,
  "status": "active",
  "subnet": "192.0.2.0/24"
}
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}");

print_r($result);
?>
```

## Get routing configuration

`GET /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#get-ovhcloudconnect-servicename-config-pop-popid-datacenter-datacenterid-extra-extraid

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/datacenter/extra/get`

Returns the route type, its BGP peer or static subnet and next hop, and its status.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `datacenterId` | path | integer | yes | Datacenter ID |
| `extraId` | path | integer | yes | Extra ID |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.DatacenterExtraConfig | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bgpNeighborArea` | integer |  | BGP AS number |
| `bgpNeighborIp` | ipv4 |  | Router IP for BGP |
| `id` | integer | read-only | ID of the extra configuration |
| `nextHop` | ipv4 |  | Static route next hop |
| `status` | ovhcloudconnect.popConfig.StatusEnum | read-only | Status of the pop configuration — one of `active`, `init`, `toDelete` |
| `subnet` | ipv4Block |  | Static route ip |
| `type` | ovhcloudconnect.datacenterExtraConfig.TypeEnum | yes | Type of the configuration — one of `bgp`, `network` |

```json
{
  "bgpNeighborArea": 0,
  "bgpNeighborIp": "192.0.2.0",
  "id": 0,
  "nextHop": "192.0.2.0",
  "status": "active",
  "subnet": "192.0.2.0/24",
  "type": "bgp"
}
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}");

print_r($result);
?>
```

## Create PoP configuration

`POST /1.0/ovhCloudConnect/{serviceName}/config/pop`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#post-ovhcloudconnect-servicename-config-pop

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/create`

Sets configuration for an interface from `interfaceList`; Provided settings depends on type L2 or L3 (async task).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `serviceName` | path | string (uuid) | yes | Service name |

### Request body (required)

Type: `ovhcloudconnect.PopConfig`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `customerBgpArea` | integer |  | Customer Private AS |
| `id` | integer | read-only | ID of the Pop Configuration |
| `interfaceId` | integer | yes | ID of the interface |
| `ovhBgpArea` | integer |  | OVH Private AS |
| `status` | ovhcloudconnect.popConfig.StatusEnum | read-only | Status of the pop configuration — one of `active`, `init`, `toDelete` |
| `subnet` | ipv4Block |  | Subnet should be a /30, first IP for OVH, second IP for customer |
| `type` | ovhcloudconnect.popConfig.TypeEnum | yes | Type of the pop configuration — one of `l2`, `l3` |

```json
{
  "customerBgpArea": 0,
  "interfaceId": 0,
  "ovhBgpArea": 0,
  "subnet": "192.0.2.0/24",
  "type": "l2"
}
```

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.Task | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `function` | ovhcloudconnect.task.FunctionEnum | read-only | Task function — one of `addDatacenterConfiguration`, `addDatacenterExtraConfiguration`, `addPopConfiguration`, `addVrack`, `consumePairingKey`, `delDatacenterConfiguration`, `delDatacenterExtraConfiguration`, `delPopConfiguration`, `deleteCircuit`, `diagAccessEdge`, `diagMacs`, `diagPeering`, … |
| `id` | integer | read-only | Task id |
| `resourceId` | integer | read-only | Reference of the created resource |
| `status` | ovhcloudconnect.task.StatusEnum | read-only | Task status — one of `denied`, `doing`, `done`, `error`, `pause`, `todo` |

```json
{
  "function": "addDatacenterConfiguration",
  "id": 0,
  "resourceId": 0,
  "status": "denied"
}
```

### Example

```bash
curl -X POST \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN" \
  -H "content-type: application/json" \
  -d '{ }'
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

# Request body type: ovhcloudconnect.PopConfig
result = client.post("/ovhCloudConnect/{serviceName}/config/pop",
	customerBgpArea = None, # Customer Private AS (type: integer, nullable)
	interfaceId = None, # ID of the interface (type: integer)
	ovhBgpArea = None, # OVH Private AS (type: integer, nullable)
	subnet = None, # Subnet should be a /30, first IP for OVH, second IP for customer (type: ipv4Block, nullable)
	type = None, # Type of the pop configuration (type: ovhcloudconnect.popConfig.TypeEnum)
)

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

// Request body type: ovhcloudconnect.PopConfig
$result = $ovh->post("/ovhCloudConnect/{serviceName}/config/pop", array(
	customerBgpArea => null, // Customer Private AS (type: integer, nullable)
	interfaceId => null, // ID of the interface (type: integer)
	ovhBgpArea => null, // OVH Private AS (type: integer, nullable)
	subnet => null, // Subnet should be a /30, first IP for OVH, second IP for customer (type: ipv4Block, nullable)
	type => null, // Type of the pop configuration (type: ovhcloudconnect.popConfig.TypeEnum)
));

print_r($result);
?>
```

## Create availability zone configuration

`POST /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#post-ovhcloudconnect-servicename-config-pop-popid-datacenter

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/datacenter/create`

Connects an availability zone to this PoP configuration; L3 also needs a /28 subnet and the OVHcloud AS (async task).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Request body (required)

Type: `ovhcloudconnect.DatacenterConfig`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `datacenterId` | integer | yes | ID of the datacenter linked |
| `id` | integer | read-only | ID of the Datacenter configuration |
| `ovhBgpArea` | integer |  | OVH Private AS |
| `status` | ovhcloudconnect.popConfig.StatusEnum | read-only | Status of the pop configuration — one of `active`, `init`, `toDelete` |
| `subnet` | ipv4Block |  | Subnet should be a /28 min |

```json
{
  "datacenterId": 0,
  "ovhBgpArea": 0,
  "subnet": "192.0.2.0/24"
}
```

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.Task | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `function` | ovhcloudconnect.task.FunctionEnum | read-only | Task function — one of `addDatacenterConfiguration`, `addDatacenterExtraConfiguration`, `addPopConfiguration`, `addVrack`, `consumePairingKey`, `delDatacenterConfiguration`, `delDatacenterExtraConfiguration`, `delPopConfiguration`, `deleteCircuit`, `diagAccessEdge`, `diagMacs`, `diagPeering`, … |
| `id` | integer | read-only | Task id |
| `resourceId` | integer | read-only | Reference of the created resource |
| `status` | ovhcloudconnect.task.StatusEnum | read-only | Task status — one of `denied`, `doing`, `done`, `error`, `pause`, `todo` |

```json
{
  "function": "addDatacenterConfiguration",
  "id": 0,
  "resourceId": 0,
  "status": "denied"
}
```

### Example

```bash
curl -X POST \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN" \
  -H "content-type: application/json" \
  -d '{ }'
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

# Request body type: ovhcloudconnect.DatacenterConfig
result = client.post("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter",
	datacenterId = None, # ID of the datacenter linked (type: integer)
	ovhBgpArea = None, # OVH Private AS (type: integer, nullable)
	subnet = None, # Subnet should be a /28 min (type: ipv4Block, nullable)
)

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

// Request body type: ovhcloudconnect.DatacenterConfig
$result = $ovh->post("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter", array(
	datacenterId => null, // ID of the datacenter linked (type: integer)
	ovhBgpArea => null, // OVH Private AS (type: integer, nullable)
	subnet => null, // Subnet should be a /28 min (type: ipv4Block, nullable)
));

print_r($result);
?>
```

## Create routing configuration

`POST /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#post-ovhcloudconnect-servicename-config-pop-popid-datacenter-datacenterid-extra

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/datacenter/extra/create`

Adds a BGP peer (`bgp`) or a static route (`network`) to this availability zone configuration (async task).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `datacenterId` | path | integer | yes | Datacenter ID |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Request body (required)

Type: `ovhcloudconnect.DatacenterExtraConfig`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bgpNeighborArea` | integer |  | BGP AS number |
| `bgpNeighborIp` | ipv4 |  | Router IP for BGP |
| `id` | integer | read-only | ID of the extra configuration |
| `nextHop` | ipv4 |  | Static route next hop |
| `status` | ovhcloudconnect.popConfig.StatusEnum | read-only | Status of the pop configuration — one of `active`, `init`, `toDelete` |
| `subnet` | ipv4Block |  | Static route ip |
| `type` | ovhcloudconnect.datacenterExtraConfig.TypeEnum | yes | Type of the configuration — one of `bgp`, `network` |

```json
{
  "bgpNeighborArea": 0,
  "bgpNeighborIp": "192.0.2.0",
  "nextHop": "192.0.2.0",
  "subnet": "192.0.2.0/24",
  "type": "bgp"
}
```

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.Task | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `function` | ovhcloudconnect.task.FunctionEnum | read-only | Task function — one of `addDatacenterConfiguration`, `addDatacenterExtraConfiguration`, `addPopConfiguration`, `addVrack`, `consumePairingKey`, `delDatacenterConfiguration`, `delDatacenterExtraConfiguration`, `delPopConfiguration`, `deleteCircuit`, `diagAccessEdge`, `diagMacs`, `diagPeering`, … |
| `id` | integer | read-only | Task id |
| `resourceId` | integer | read-only | Reference of the created resource |
| `status` | ovhcloudconnect.task.StatusEnum | read-only | Task status — one of `denied`, `doing`, `done`, `error`, `pause`, `todo` |

```json
{
  "function": "addDatacenterConfiguration",
  "id": 0,
  "resourceId": 0,
  "status": "denied"
}
```

### Example

```bash
curl -X POST \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN" \
  -H "content-type: application/json" \
  -d '{ }'
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

# Request body type: ovhcloudconnect.DatacenterExtraConfig
result = client.post("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra",
	bgpNeighborArea = None, # BGP AS number (type: integer, nullable)
	bgpNeighborIp = None, # Router IP for BGP (type: ipv4, nullable)
	nextHop = None, # Static route next hop (type: ipv4, nullable)
	subnet = None, # Static route ip (type: ipv4Block, nullable)
	type = None, # Type of the configuration (type: ovhcloudconnect.datacenterExtraConfig.TypeEnum)
)

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

// Request body type: ovhcloudconnect.DatacenterExtraConfig
$result = $ovh->post("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra", array(
	bgpNeighborArea => null, // BGP AS number (type: integer, nullable)
	bgpNeighborIp => null, // Router IP for BGP (type: ipv4, nullable)
	nextHop => null, // Static route next hop (type: ipv4, nullable)
	subnet => null, // Static route ip (type: ipv4Block, nullable)
	type => null, // Type of the configuration (type: ovhcloudconnect.datacenterExtraConfig.TypeEnum)
));

print_r($result);
?>
```

## Delete PoP configuration

`DELETE /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#delete-ovhcloudconnect-servicename-config-pop-popid

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/delete`

Removes the PoP configuration from its interface (async task).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.Task | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `function` | ovhcloudconnect.task.FunctionEnum | read-only | Task function — one of `addDatacenterConfiguration`, `addDatacenterExtraConfiguration`, `addPopConfiguration`, `addVrack`, `consumePairingKey`, `delDatacenterConfiguration`, `delDatacenterExtraConfiguration`, `delPopConfiguration`, `deleteCircuit`, `diagAccessEdge`, `diagMacs`, `diagPeering`, … |
| `id` | integer | read-only | Task id |
| `resourceId` | integer | read-only | Reference of the created resource |
| `status` | ovhcloudconnect.task.StatusEnum | read-only | Task status — one of `denied`, `doing`, `done`, `error`, `pause`, `todo` |

```json
{
  "function": "addDatacenterConfiguration",
  "id": 0,
  "resourceId": 0,
  "status": "denied"
}
```

### Example

```bash
curl -X DELETE \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.delete("/ovhCloudConnect/{serviceName}/config/pop/{popId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->delete("/ovhCloudConnect/{serviceName}/config/pop/{popId}");

print_r($result);
?>
```

## Delete availability zone configuration

`DELETE /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#delete-ovhcloudconnect-servicename-config-pop-popid-datacenter-datacenterid

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/datacenter/delete`

Disconnects the availability zone from this PoP configuration (async task).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `datacenterId` | path | integer | yes | Datacenter ID |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.Task | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `function` | ovhcloudconnect.task.FunctionEnum | read-only | Task function — one of `addDatacenterConfiguration`, `addDatacenterExtraConfiguration`, `addPopConfiguration`, `addVrack`, `consumePairingKey`, `delDatacenterConfiguration`, `delDatacenterExtraConfiguration`, `delPopConfiguration`, `deleteCircuit`, `diagAccessEdge`, `diagMacs`, `diagPeering`, … |
| `id` | integer | read-only | Task id |
| `resourceId` | integer | read-only | Reference of the created resource |
| `status` | ovhcloudconnect.task.StatusEnum | read-only | Task status — one of `denied`, `doing`, `done`, `error`, `pause`, `todo` |

```json
{
  "function": "addDatacenterConfiguration",
  "id": 0,
  "resourceId": 0,
  "status": "denied"
}
```

### Example

```bash
curl -X DELETE \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.delete("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->delete("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}");

print_r($result);
?>
```

## Delete routing configuration

`DELETE /1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}`

Link: https://developers.eu.ovhcloud.com/reference/network/ovhcloud-connect/configuration/#delete-ovhcloudconnect-servicename-config-pop-popid-datacenter-datacenterid-extra-extraid

**Status:** Stable production version  
**IAM actions:** `ovhCloudConnect:apiovh:config/pop/datacenter/extra/delete`

Removes the BGP peer or static route (async task).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `datacenterId` | path | integer | yes | Datacenter ID |
| `extraId` | path | integer | yes | Extra ID |
| `popId` | path | integer | yes | Pop ID |
| `serviceName` | path | string (uuid) | yes | Service name |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | ovhcloudconnect.Task | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `function` | ovhcloudconnect.task.FunctionEnum | read-only | Task function — one of `addDatacenterConfiguration`, `addDatacenterExtraConfiguration`, `addPopConfiguration`, `addVrack`, `consumePairingKey`, `delDatacenterConfiguration`, `delDatacenterExtraConfiguration`, `delPopConfiguration`, `deleteCircuit`, `diagAccessEdge`, `diagMacs`, `diagPeering`, … |
| `id` | integer | read-only | Task id |
| `resourceId` | integer | read-only | Reference of the created resource |
| `status` | ovhcloudconnect.task.StatusEnum | read-only | Task status — one of `denied`, `doing`, `done`, `error`, `pause`, `todo` |

```json
{
  "function": "addDatacenterConfiguration",
  "id": 0,
  "resourceId": 0,
  "status": "denied"
}
```

### Example

```bash
curl -X DELETE \
  "https://api.eu.ovhcloud.com/1.0/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}" \
  -H "accept: application/json" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.delete("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->delete("/ovhCloudConnect/{serviceName}/config/pop/{popId}/datacenter/{datacenterId}/extra/{extraId}");

print_r($result);
?>
```