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

RegisterInstancesWithSecurityGroup

処理概要

指定したファイアウォールグループを、指定したサーバーへ適用します。

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

またサーバーを指定するためには、サーバー名が必要です。

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

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

指定するパラメーター

パラメーター	型	説明	必須
GroupName	string	ファイアウォールグループ名	○
InstanceId.n	string	サーバー名	○

応答フィールド

フィールド (項目)	型	説明
RegisterInstancesWithSecurityGroupResponse	-	RegisterInstancesWithSecurityGroup レスポンス
␣requestId	string	リクエスト識別子
␣instancesSet	-	適用に成功したサーバーの情報セット
␣␣item	-	適用に成功したサーバーの情報
␣␣␣instanceId	string	サーバー名

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=RegisterInstancesWithSecurityGroup
  &GroupName=group01
  &InstanceId.1=server04
  &InstanceId.2=server05
  &CommonParams

  

応答サンプル

    <RegisterInstancesWithSecurityGroupResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <instancesSet>
    <item>
      <instanceId>server04</instanceId>
    </item>
    <item>
      <instanceId>server05</instanceId>
    </item>
  </instancesSet>
</RegisterInstancesWithSecurityGroupResponse>