Update VPN service
Updates a VPN service, provided status is not indicating a PENDING_* state.
URI
/v2.0/vpn/vpnservices/{service-id}
HTTP method
PUT
Request parameter
Key | Description | Type | Required/optional |
---|---|---|---|
name | Human readable name for the VPN service. Does not have to be unique. | string | Optional |
admin_state_up | Administrative state of the vpnservice. If false (down), port does not forward packets. | bool | Optional |
description | Human readable description for the VPN service. | string | Optional |
Example request
{
"vpnservice": {
"description": "Updated description"
}
}
Response status
Status code | Description |
---|---|
200 | Normal response codes |
Unauthorized (401) | Error response codes |
Bad Request (400) | Error response codes |
Not Found (404) | Error response codes |
Response body (normal status)
{
"vpnservice": {
"router_id": "881b7b30-4efb-407e-a162-5630a7af3595",
"status": "ACTIVE",
"name": "myvpn",
"admin_state_up": true,
"subnet_id": "25f8a35c-82d5-4f55-a45b-6965936b33f6",
"tenant_id": "26de9cd6cae94c8cb9f79d660d628e1f",
"id": "41bfef97-af4e-4f6b-a5d3-4678859d2485",
"description": "Updated description",
"availability_zone": "AZ1"
}
}
Description of response body (normal status)
Item | Description |
---|---|
router_id | Router ID to which the VPN service is inserted. |
status | Indicates whether IPsec VPN service is currently operational. Possible values include: ACTIVE, DOWN, BUILD, ERROR, PENDING_CREATE, PENDING_UPDATE, or PENDING_DELETE. |
name | Human readable name for the VPN service. Does not have to be unique. |
admin_state_up | Administrative state of the vpnservice. If false (down), port does not forward packets. |
subnet_id | The subnet on which the project wants the VPN service. |
tenant_id | Owner of the VPN service. Only admin users can specify a project identifier other than their own. |
id | Unique identifier for the VPN Service object. |
description | Human readable description for the VPN service. |
availability_zone | The Availability Zone name. |