本文へジャンプします。

ニフティクラウド APIリファレンス

DeregisterInstancesFromSecurityGroup

処理概要

指定したファイアウォールグループから、指定したサーバーをはずします。

ファイアウォールグループを指定するためには、ファイアウォールグループ名が必要です。削除済みのファイアウォールグループを指定した、管理外のファイアウォールグループを指定したなど、無効なファイアウォールグループを指定した場合は、エラーが返されます。

またサーバーを指定するためには、サーバー名が必要です。指定したファイアウォールグループに適用されていないサーバーを指定した、削除済みのサーバーを指定した、管理外のサーバーを指定したなど、無効なサーバーを指定した場合は、エラーが返されます。

ファイアウォールグループからサーバーをはずすには、時間がかかることがあります。

API「DescribeSecurityGroups」のレスポンス値「groupStatus」でファイアウォールグループのステータスを確認できます。
また、ファイアウォールグループのステータスが「適用済み」の場合、はずしたサーバーが正しくファイアウォールグループに反映されているかの確認が必要です。
同じくAPI「DescribeSecurityGroups」のレスポンス値「instancesSet」で確認できます。

指定するパラメーター

パラメーター 説明 必須 サンプル値
GroupName ファイアウォールグループ名
Type : String
group01
InstanceId.n サーバー名
Type : String
server02

応答フィールド

フィールド(項目) 説明 サンプル値
DeregisterInstances
FromSecurityGroupResponse
DeregisterInstancesFromSecurityGroup レスポンス
Type : DeregisterInstancesFromSecurityGroup ResponseType
Ancestor : なし
Children : requestId, instancesSet
 
requestId リクエスト識別子
Type : xsd:string
Ancestor : DeregisterInstancesFromSecurityGroup Response
Children : なし
f6dd8353-eb6b-6b4fd32e4f05
instancesSet 解除に成功したサーバーの情報セット
Type : InstanceIdSetType
Ancestor : DeregisterInstancesFromSecurityGroup
Children : item
 
item 解除に成功したサーバーの情報
Type : InstanceIdType
Ancestor : instancesSet
Children : instanceId
 
instanceId サーバー名
Type : xsd:string
Ancestor : item
Children : なし
 

リクエストサンプル

https://cp.cloud.nifty.com/api/?Action=DeregisterInstancesFromSecurityGroup
&GroupName=group01&InstanceId.1=server01&InstanceId.2=server02&CommonParams

応答サンプル

<DeregisterInstancesFromSecurityGroupResponse xmlns="https://cp.cloud.nifty.com/api/">
  <requestId>320fc738-a1c7-4a2f-abcb-20813a4e997c</requestId>
  <instancesSet>
   <item>
    <instanceId>server01</instanceId>
   </item>
   <item>
    <instanceId>server02</instanceId>
   </item>
  </instancesSet>
</DeregisterInstancesFromSecurityGroupResponse>

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

APIメニュー

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

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