Update IPsec site connection
ステータスがPENDING_*でなければ、IPSecサイト間接続を更新します。
URI
/v2.0/vpn/ipsec-site-connections/{connection-id}
HTTPメソッド
PUT
リクエストパラメタ
キー | 説明 | 型 | 必須/省略可 |
---|---|---|---|
psk | PSK(事前共有鍵): 任意の文字列 | string | Optional |
initiator | このVPNが接続に応答するだけか、開始も行うかを指定します。"bi-directional"または"response-only"を選択してください。
(デフォルト: bi-directional) |
string | Optional |
admin_state_up | VPN接続の管理状態
"false"(停止中)の場合、VPN接続はパケットを転送しません。 |
bool | Optional |
peer_cidrs | ピアのプライベートCIDR
<net_address>/<prefix>の書式で示される有効なCIDRの固有リスト。指定可能なCIDRは1つだけです。 |
list | Optional |
dpd | DPD (Dead Peer Detection)プロトコルの制御
アクションの値はhold またはrestartを指定します。 間隔とタイムアウトの値は秒単位で指定します。 (デフォルト: {'action' : 'hold', 'interval' : 30, 'timeout' : 120) |
dict | Optional |
peer_address | ピアのゲートウェイ公開IPv4アドレス | string | Optional |
peer_id | ピアのルーターの認証情報
有効な値は、IPv4/IPv6アドレス、メールアドレス、キーID、またはFQDNです。 |
string | Optional |
name | IPSecサイト間接続の名前 | string | Optional |
description | IPSecサイト間接続の説明 | string | Optional |
リクエスト例
{
"ipsec_site_connection": {
"description": "to datacenter2"
}
}
レスポンスステータス
ステータスコード | 説明 |
---|---|
200 | Normal response codes |
Unauthorized (401) | Error response codes |
Bad Request (400) | Error response codes |
Not Found (404) | Error response codes |
レスポンスボディ(正常系)
{
"ipsec_site_connection": {
"status": "DOWN",
"psk": "secret",
"initiator": "bi-directional",
"name": "vpnconnection1",
"admin_state_up": true,
"tenant_id": "26de9cd6cae94c8cb9f79d660d628e1f",
"description": " to datacenter2",
"auth_mode": "psk",
"peer_cidrs": [
"10.2.0.0/24"
],
"mtu": 1500,
"ikepolicy_id": "771f081c-5ec8-4f9a-b041-015dfb7fbbe2",
"dpd": {
"action": "hold",
"interval": 30,
"timeout": 120
},
"route_mode": "static",
"vpnservice_id": "41bfef97-af4e-4f6b-a5d3-4678859d2485",
"peer_address": "172.24.4.233",
"peer_id": "172.24.4.233",
"id": "f7cf7305-f491-45f4-ad9c-8e7240fe3d72",
"ipsecpolicy_id": "9958d4fe-3719-4e8c-84e7-9893895b76b4",
"availability_zone": "AZ1"
}
}
レスポンスボディ(正常系)の説明
要素名 | 説明 |
---|---|
status | VPNコネクションの状態
値は次のいずれかとなります:ACTIVE / DOWN / BUILD / ERROR / PENDING_CREATE / PENDING_UPDATE / PENDING_DELETE |
psk | PSK(事前共有鍵): 任意の文字列 |
initiator | このVPNが接続に応答するだけか、開始も行うかを指定します。 |
name | IPSecサイト間接続の名前 |
admin_state_up | VPN接続の管理状態
"false"(停止中)の場合、VPN接続はパケットを転送しません。 |
tenant_id | プロジェクトID |
description | IPSecサイト間接続の説明 |
auth_mode | 認証モード: psk |
peer_cidrs | ピアのプライベートCIDR |
mtu | 1度に伝送可能な最大データ量 |
ikepolicy_id | IKEポリシーID |
dpd | DPD (Dead Peer Detection)プロトコルの制御
アクションの値はhold またはrestartを指定します。 間隔とタイムアウトの値は秒単位で指定します。 |
route_mode | ルートモード: static
今後拡張する予定です。 |
vpnservice_id | VPNサービスID |
peer_address | ピアのゲートウェイ公開IPv4アドレス |
peer_id | ピアのルーターの認証情報
有効な値は、IPv4/IPv6アドレス、メールアドレス、キーID、またはFQDNです。 |
id | IPSecコネクションID |
ipsecpolicy_id | IPSecポリシーID |
availability_zone | アベイラビリティゾーン名 |
注意:
リソース更新後、接続相手先の設定が完了しているにも関わらず、statusがACTIVEにならない場合、「List IPsec site connections」の注意点に記載の事項に関して確認してください。