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>