ニフクラAPI (コンピューティング: UpdateSecurityGroup)

UpdateSecurityGroup

処理概要

ファイアウォールグループの設定情報を更新します。1回のリクエストで、1つのファイアウォールグループの情報を更新できます。

ファイアウォールグループを指定するためには、ファイアウォールグループ名が必要です。

ファイアウォールグループの設定情報の更新には、時間がかかることがあります。API「DescribeSecurityGroups」のレスポンス値「groupStatus」でファイアウォールグループのステータスを確認できます。
また、ファイアウォールグループのステータスが「適用済み」の場合、更新した情報が正しくファイアウォールグループに反映されているかの確認が必要です。同じくAPI「DescribeSecurityGroups」のレスポンス値で確認できます。

なお、パラメーター「GroupLogFilterNetBios」と「GroupLogFilterBroadcast」については、指定した場合でもDefaultの値が適用されます。

指定するパラメーター

パラメーター	型	説明	必須
GroupName	string	ファイアウォールグループ名	○
GroupNameUpdate	string	ファイアウォールグループ名の変更 Default: 変更なし 使用可能文字: 半角英数字(15文字まで)
GroupDescriptionUpdate	string	ファイアウォールグループのメモの変更 Default: 変更なし 使用可能文字: 40文字以内※4バイト文字（絵文字や一部の漢字など）は使用できません。
GroupRuleLimitUpdate	integer	※指定不可 ファイアウォールグループのルール数上限の変更 Default: 変更なし
GroupLogLimitUpdate	integer	ファイアウォールグループのログ取得件数の変更 Default: 変更なし 使用可能文字: 1000, 100000
GroupLogFilterNetBios	boolean	※指定不可 WindowsサーバーのBroadcast通信ログの抑止状態 Default: false (抑止しない)
GroupLogFilterBroadcast	boolean	※指定不可 ブロードキャスト通信ログの抑止状態 Default: true (抑止する)

応答フィールド

フィールド (項目)	型	説明
UpdateSecurityGroupResponse	-	UpdateSecurityGroup レスポンス
␣requestId	string	リクエスト識別子
␣return	boolean	処理ステータス 値: true (成功)

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=UpdateSecurityGroup
  &GroupName=group01
  &GroupDescriptionUpdate=Security Group memo.Updated.
  &CommonParams

  

応答サンプル

    <UpdateSecurityGroupResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <return>true</return>
</UpdateSecurityGroupResponse>