associate-address

Description

指定したサーバーへ付替IPアドレスを追加します。

元々サーバーに割り当てられていたIPアドレスは、付替IPアドレス設定中は確保された状態となり、付替IPアドレス解除時に再設定されます。

また付替IPアドレスの反映には、サーバーの再起動が必要になります。

再起動オプションをfalseで指定する場合はサーバー停止時のみ選択可能です。

付替IPアドレスをサーバーへ追加するには、サーバーの再起動もあり時間がかかることがあります。

サーバーのステータスは、API「DescribeInstances」のレスポンス値「instanceState」で確認できます。

また、付替IPアドレスが正しくサーバーに反映されているかの確認が必要です。

同じくAPI「DescribeInstances」のレスポンス値「ipType」もしくはAPI「DescribeAddresses」のレスポンス値「instanceId」で確認できます。

See also: NIFCLOUD API Documentation

Synopsis

  associate-address
[--allocation-id <value>]
[--allow-reassociation | --no-allow-reassociation]
--instance-id <value>
[--network-interface-id <value>]
[--nifty-reboot <value>]
[--private-ip-address <value>]
[--public-ip <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]

Options

--allocation-id (string)

--allow-reassociation | --no-allow-reassociation (boolean)

--instance-id (string)

--network-interface-id (string)

--nifty-reboot (string)

Possible values:

  • force

  • true

  • false

--private-ip-address (string)

--public-ip (string)

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command’s default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination.

--output (string)

The formatting style for command output.

  • json

  • text

  • table

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

  • on

  • off

  • auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

Output

RequestId -> (string)

Return -> (boolean)