NiftyModifyVpnGatewayAttribute
処理概要
指定された拠点間VPNゲートウェイの詳細情報を更新します。1回のリクエストで、1つの拠点間VPNゲートウェイの情報を更新できます。
拠点間VPNゲートウェイを指定するためには、拠点間VPNゲートウェイIDまたは拠点間VPNゲートウェイ名が必要です。処理中の拠点間VPNゲートウェイを指定した、削除済みの拠点間VPNゲートウェイを指定した、管理外の拠点間VPNゲートウェイを指定したなど、無効な拠点間VPNゲートウェイを指定した場合は、エラーが返されます。
拠点間VPNゲートウェイ名、拠点間VPNゲートウェイタイプの更新時、拠点間VPNゲートウェイがバックアップを保持している場合は、パラメーター「Agreement」に「true」を設定し、バックアップを解除する必要があります。バックアップを保持しているかどうかはAPI「DescribeVpnGateways」のレスポンス値「isBackup」で確認できます。
指定するパラメーター
| パラメーター | 説明 | 必須 | サンプル値 |
|---|---|---|---|
| VpnGatewayId | 拠点間VPNゲートウェイユニークID Type : String |
○ （拠点間VPNゲートウェイ名といずれか） |
|
| NiftyVpnGatewayName | 拠点間VPNゲートウェイ名 Type : String |
○ （拠点間VPNゲートウェイユニークIDといずれか） |
|
| Attribute | 更新対象の項目名 Type : String 値: niftyVpnGatewayName（拠点間VPNゲートウェイ名を更新） | niftyVpnGatewayType（拠点間VPNゲートウェイタイプを更新） | niftyVpnGatewayDescription（メモを更新） | niftyVpnGatewayAccountingType（利用料金タイプを更新）| groupId（ファイアウォールを更新） |
○ | |
| Value | 更新値 Type : String 値 : [Attribute=niftyVpnGatewayType] small | medium | large [Attribute=niftyVpnGatewayDescription] 空指定の場合、空で上書き [Attribute=accountingType] 1 (月額課金) | 2 (従量課金) |
○ | |
| Agreement | version up実施したのち、バックアップ状態を解除する事項への同意 Type:bBoolean Default:false |
○ （バックアップを保持する場合のみ） |
応答フィールド
| フィールド | 説明 | サンプル値 |
|---|---|---|
| NiftyModifyVpnGatewayAttributeResponse | NiftyModifyVpnGatewayAttributeレスポンス Type : NiftyModifyVpnGatewayAttributeResponseType Ancestor : なし Children : requestId, return |
|
| requestId | リクエスト識別子 Type : xsd:string Ancestor : NiftyModifyVpnGatewayAttributeResponse Children : なし |
ac501097-4c8d-475b-b06b-a90048ec181c |
| return | 更新ステータス Type : xsd:boolean 値 : true (成功) Ancestor : NiftyModifyVpnGatewayAttributeResponse Children : なし |
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/?Action=NiftyModifyVpnGatewayAttribute&VpnGatewayId=vgw-8db04f81&Attribute=niftyVpnGatewayDescription&Value=VPNmemoUpdate&CommonParams応答サンプル
<NiftyModifyVpnGatewayAttributeResponse xmlns="https://computing.api.nifcloud.com/api/">
<requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
<return>true</return>
</NiftyModifyVpnGatewayAttributeResponse>
