翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `register` コマンドの使用
<a name="registered-instances-register-registering-command"></a>

**重要**  
この AWS OpsWorks Stacks サービスは 2024 年 5 月 26 日にサポート終了となり、新規および既存のお客様の両方で無効になっています。できるだけ早くワークロードを他のソリューションに移行することを強くお勧めします。移行についてご質問がある場合は、[AWS re:Post](https://repost.aws/) または[AWS プレミアムサポート](https://aws.amazon.com/support)を通じて AWS サポート チームにお問い合わせください。

**注記**  
この機能は Linux スタックでのみサポートされています。

インスタンスを登録するには、 AWS CLIのバージョンが少なくとも 1.16.180 でなければなりません。`register` コマンドの一般的な構文を次に示します。

```
aws opsworks register \
  [--profile profile_name] \
  [--region region_name] \
  --infrastructure-class instance_type \
  --stack-id stack ID \
  [--local] | [--ssh-private-key key_file --ssh-username username] | [--override-ssh command_string] \
  [--override-hostname hostname] \
  [--debug] \
  [--override-public-ip public IP] \
  [--override-private-ip private IP] \
..[--use-instance-profile] \
  [ [IP address] | [hostname] | [instance ID]
```

以下の引数はすべての AWS CLI コマンドに共通です。

**`--profile`**  
(オプション) 認証情報のプロファイル名。この引数を省略すると、コマンドはデフォルトの認証情報を使用して実行されます。がデフォルトの認証情報 AWS CLI を決定する方法の詳細については、[「AWS コマンドラインインターフェイスの設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)」を参照してください。

**`--region`**  
 (オプション) OpsWorks スタックサービスエンドポイントのリージョン。をスタックのリージョン`--region`に設定しないでください。 OpsWorks スタックはスタック ID からスタックのリージョンを自動的に決定します。  
デフォルトのリージョンがすでに設定されている場合は、この引数を省略できます。デフォルトのリージョンを指定する方法の詳細については、「[AWS コマンドラインインターフェイスの設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)」を参照してください。

Amazon EC2 インスタンスとオンプレミス インスタンスのどちらの場合も、以下の引数を使用します。

**`--infrastructure-class`**  
(必須) このパラメータを `ec2` または `on-premises` のいずれかに設定して、Amazon EC2 インスタンスと オンプレミス インスタンスのどちらを登録するのかを指定する必要があります。

**`--stack-id`**  
(必須) インスタンスを登録するスタックの ID。  
スタック ID を見つけるには、[**Stack (スタック)**] ページで [**Settings (設定)**] を選択します。スタック ID は [**OpsWorks ID**] というラベルで `ad21bce6-7623-47f1-bf9d-af2affad8907` のように表示されます。

**SSH ログイン引数**  
`register` でインスタンスにログインする方法を指定するには、次の引数を使用します。    
**`--local`**  
(オプション) この引数は、コマンドを実行する対象のインスタンスを登録するために使用します。  
この場合、`register` でインスタンスにログインする必要はありません。  
**`--ssh-private-key` および `--ssh-username`**  
 (オプション) 別のワークステーションからインスタンスを登録する場合に、ユーザー名またはプライベートキーファイルを明示的に指定するには、これらの引数を使用します。  
+ `--ssh-username` - この引数は、SSH ユーザー名を指定するために使用します。

  `--ssh-username` を省略すると、`ssh` はデフォルトのユーザー名を使用します。
+ `--ssh-private-key` - この引数は、プライベートキーファイルを明示的に指定する場合に使用します。

  `--ssh-private-key` を省略すると、`ssh` は、デフォルトのプライベートキーの使用などの、パスワード不要の認証方法によるログインを試みます。それらの方法のいずれもサポートされていない場合、`ssh` はパスワードを問い合わせます。`ssh` で認証がどのように処理されるかの詳細については、「[Secure Shell (SSH) 認証プロトコル](https://www.ietf.org/rfc/rfc4252.txt)」を参照してください。  
**`--override-ssh`**  
 (オプション) この引数は、別のワークステーションから登録する場合に、カスタムの [http://linux.about.com/od/commands/l/blcmdl1_ssh.htm](http://linux.about.com/od/commands/l/blcmdl1_ssh.htm) コマンド文字列を指定するときに使用します。`register` コマンドは、このコマンド文字列を使用して、登録されたインスタンスにログインします。
`ssh` の詳細については、「[SSH](http://www.openbsd.org/cgi-bin/man.cgi/OpenBSD-current/man1/slogin.1)」を参照してください

**`--override-hostname`**  
 (オプション) インスタンスのホスト名を指定します。これは OpsWorks スタックでのみ使用されます。デフォルト値はインスタンスのホスト名です。

**`--debug`**  
(オプション) 登録処理が失敗した場合にデバッグ情報を提供します。トラブルシューティング情報については、「[インスタンス登録の問題のトラブルシューティング](common-issues.md#common-issues-instance-registration)」を参照してください。

**`--use-instance-profile`**  
(オプション。ただし、Amazon EC2 インスタンスでは強く推奨) `register` コマンドで、IAM ユーザーを作成するのではなく、アタッチされたインスタンスプロファイルを使用するようにします。このパラメータを追加すると、IAM ユーザーが誤って削除された場合に登録済みインスタンスを管理しようしたときに発生するエラーを回避するうえで役立ちます。  
登録プロセス中に作成された IAM ユーザーは、登録されたインスタンスの存続中に必要です。ユーザーを削除すると、 OpsWorks スタックエージェントは サービスと通信できなくなります。`--use-instance-profile` ユーザーが誤って削除された場合に登録済みインスタンスの管理に関する問題が発生するのを回避するために、 `register`コマンドに パラメータを追加して、代わりにインスタンスの組み込みインスタンスプロファイルを使用します。また、 `--use-instance-profile`パラメータを追加すると、 AWS アカウントアクセスキーを 90 日ごとにローテーションするときにエラーが発生することも防止されます (推奨されるベストプラクティス）。これは、 OpsWorks エージェントが使用できるアクセスキーと必要なユーザーとの間の不一致を防ぐためです。

**ターゲット**  
(条件付き) ワークステーションからこのコマンドを実行する場合、コマンド文字列の最終値で、次のいずれかの方法で登録ターゲットを指定します。  
+ インスタンスのパブリック IP アドレス。
+ インスタンスのホスト名。
+ Amazon EC2 インスタンスの インスタンス ID。

  OpsWorks スタックはインスタンス ID を使用して、インスタンスのパブリック IP アドレスを含むインスタンス設定を取得します。デフォルトでは、 OpsWorks Stacks はこのアドレスを使用して、インスタンスへのログインに使用する`ssh`コマンド文字列を作成します。プライベート IP アドレスに接続する必要がある場合は、`--override-ssh` を使用してカスタムコマンド文字列を提供する必要があります。例については、[ワークステーションからのオンプレミスインスタンスの登録](registered-instances-register-registering-examples.md#registered-instances-register-registering-examples-workstation-onprem)を参照してください。
ホスト名を指定すると、`ssh` は DNS サーバーを使用して名前を特定のインスタンスに解決します。ホスト名が一意かどうか不確かな場合は、`ssh` を使用して、ホスト名が正しいインスタンスに解決されることを確認します。
登録するインスタンスからこのコマンドを実行する場合は、インスタンス識別子を省略し、代わりに `--local` 引数を使用します。

以下の引数は オンプレミス インスタンスの場合のみ使用できます。

**`--override-public-ip`**  
(オプション) OpsWorks スタックは、指定されたアドレスをインスタンスのパブリック IP アドレスとして表示します。インスタンスのパブリック IP アドレスは変更されません。ただし、インスタンスページでアドレスを選択するなど、ユーザーがコンソールを使用して**インスタンス**に接続する場合、 OpsWorks スタックは指定されたアドレスを使用します。 OpsWorks スタックは引数のデフォルト値を自動的に決定します。

**`--override-private-ip`**  
(オプション) OpsWorks スタックは、指定されたアドレスをインスタンスのプライベート IP アドレスとして表示します。インスタンスのプライベート IP アドレスは変更されません。 OpsWorks スタックは引数のデフォルト値を自動的に決定します。