本文へジャンプします。

ニフクラ APIリファレンス

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://cp.cloud.nifty.com/api/">
 <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
 <return>true</return>
</NiftyModifyVpnGatewayAttributeResponse>

ニフティクラウド サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ

推奨画面サイズ 1024×768 以上