Snowball Edge での Amazon EC2-compatibleエンドポイントの使用

• --instance-id – 単一の sbe インスタンスの ID。

• --public-ip – インスタンスへのアクセスに使用する仮想 IP アドレス。

• --device value — デバイス名。

• --instance-id – ターゲットの Amazon EC2 互換インスタンスの ID。

• -volume-id value — EBS ボリュームの ID。

• --group-id value — セキュリティグループの ID

• [--ip-permissions value] — IP アクセス許可の 1 つ以上のセット。

• [--group-name value] — セキュリティグループ名。

• [--group-id value] — セキュリティグループの ID

• [--ip-permissions value] — IP アクセス許可の 1 つ以上のセット。

• [--protocol value] IP プロトコル。指定できる値は tcp、udp、および icmp です。「すべてのプロトコル」が指定されている場合を除き、--port 引数は必須です (-1)。

• [--port value] — TCP または UDP 用に許可するポートの範囲。この値は、1 つの整数または範囲 (最小/最大) です。

  ICMP の場合、1 つの整数または範囲 (type-code) です。この場合、type は ICMP タイプ番号を表し、code は ICMP コード番号を表します。-1 の値は、すべての ICMP タイプのすべての ICMP コードを示します。type だけの -1 の値は、特定の ICMP タイプのすべての ICMP コードを示します。

• [--cidr value] — CIDR IP の範囲。

• --launch-template-name string — 起動テンプレート名。

• --launch-template-data structure — 起動テンプレートの情報。以下の属性がサポートされています。

  • ImageId

  • InstanceType

  • SecurityGroupIds

  • TagSpecifications

  • UserData

  JSON 構文:

  {
      "ImageId":"string",
      "InstanceType":"sbe-c.large",
      "SecurityGroupIds":["string", ...],
      "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"},
      {"Key":"Stack","Value":"Gamma"}]}],
      "UserData":"this is my user data"
  }                                

• [--version-description string] — 起動テンプレートの最初のバージョンの説明。

• --endpoint snowballEndpoint – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する」を参照してください。

• --launch-template-id string — 起動テンプレートの ID。

• --launch-template-name string — 起動テンプレート名。

• --launch-template-data structure — 起動テンプレートの情報。以下の属性がサポートされています。

  • ImageId

  • InstanceType

  • SecurityGroupIds

  • TagSpecifications

  • UserData

  JSON 構文:

  {
      "ImageId":"string",
      "InstanceType":"sbe-c.large",
      "SecurityGroupIds":["string", ...],
      "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"},
       {"Key":"Stack","Value":"Gamma"}]}],
      "UserData":"this is my user data"
  }                              

• [--source-version string] — 新しいバージョンの基となる起動テンプレートのバージョン番号。新しいバージョンは、launch-template-data で指定したパラメータを除いて、基になるバージョンと同じ起動パラメータを継承します。

• [--version-description string] — 起動テンプレートの最初のバージョンの説明。

• --endpoint snowballEndpoint – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する」を参照してください。

• AMI

• インスタンス

• 起動テンプレート

• セキュリティグループ

• キーペア

• --group-name value — セキュリティグループ名。

• --description value — セキュリティグループの説明。これは、情報提供のみを目的としています。この値の長さは最大 255 文字とすることができます。

• [--size value] — GiB 単位のボリュームのサイズで、1 GiB～1 TB (1000 GiB) とすることができます。

• [--snapshot-id value] — ボリュームの作成元となるスナップショット。

• [--volume-type value] — ボリュームのタイプ。値が指定されていない場合、デフォルト値は sbg1 です。以下に示しているのは、可能な値です。

  • マグネティックボリュームの sbg1

  • SSD ボリュームの sbp1

• [--tag-specification value] — 作成中にボリュームに適用するタグのリスト。

• --launch-template-id string — 起動テンプレートの ID。

• --launch-template-name string — 起動テンプレート名。

• --endpoint snowballEndpoint – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する」を参照してください。

• --launch-template-id string — 起動テンプレートの ID。

• --launch-template-name string — 起動テンプレート名。

• --versions (list) "string" "string" — 削除する 1 つ以上の起動テンプレートバージョンのバージョン番号。

• --endpoint snowballEndpoint – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する」を参照してください。

• --group-name value — セキュリティグループ名。

• --description value — セキュリティグループの説明。これは、情報提供のみを目的としています。この値の長さは最大 255 文字とすることができます。

• --volume-id value — ボリュームの ID。

• --public-ips – インスタンスに関連付けられている 1 つ以上の仮想 IP アドレス。

• --image-id — AMI の Snowball AMI ID。

• instanceInitiatedShutdownBehavior

• instanceType

• userData

• --instance-ids – デバイスで停止した 1 つ以上の sbe インスタンスの ID。

• --page-size — 呼び出しで取得する各ページのサイズ。この値は、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、デバイスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。こうすることで、呼び出しのタイムアウトを防ぐことができます。

• --max-items — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。

• --starting-token — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。

• ステータスチェック – Snow デバイスは、実行中の Amazon EC2 互換インスタンスのステータスチェックを実行して、ハードウェアおよびソフトウェアの問題を特定します。

• インスタンスの状態 – インスタンスを起動した瞬間から終了時までインスタンスを管理できます。

• [--filters] (リスト)

  フィルター。

  • instance-state-code – 16 ビットの符号なし整数としてのインスタンスの状態のコード。上位バイトは内部サービスレポート目的で使用されるため、無視します。下位バイトは表示されている状態に基づいて設定されます。有効な値は 0 (保留中)、16 (実行中)、32 (シャットダウン中)、48 (終了)、64 (停止中)、80 (停止) です。

  • instance-state-name – インスタンスの状態 (pending | running | shutting-down | terminated | stopping | stopped )。

  • instance-status.reachability – 名前が reachability (passed | failed | initializing | insufficient-data ) のインスタンスステータスに基づいてフィルタリングします。

  • instance-status.status – インスタンスのステータス (ok | impaired | initializing | insufficient-data | not-applicable )。

  • system-status.reachability – 名前が reachability (passed | failed | initializing | insufficient-data ) のシステムステータスに基づいてフィルタリングします。

  • system-status.status – インスタンスのシステムステータス (ok | impaired | initializing | insufficient-data | not-applicable )。

• JSON 構文:

  [
    {
      "Name": "string",
      "Values": ["string", ...]
    }
    ...
  ]

• [--instance-ids] (リスト)

  インスタンス ID。

  デフォルト: すべてのインスタンスについて説明します。

• [--dry-run|--no-dry-run] (ブーリアン)

  実際にリクエストを行わずに、ユーザーがアクションに必要なアクセス許可を持っているかどうかをチェックし、エラーレスポンスを返します。必要なアクセス許可がある場合、エラーレスポンスは DryRunOperation です。

  それ以外の場合は、UnauthorizedOperation です。

• [--include-all-instances | --no-include-all-instances] (ブーリアン)

  true の場合、すべてのインスタンスのヘルスステータスが含まれます。false の場合、実行中のインスタンスのみのヘルスステータスが含まれます。

  デフォルト: false

• [--page-size] (整数) – 呼び出しで取得する各ページのサイズ。この値は、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、デバイスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。こうすることで、呼び出しのタイムアウトを防ぐことができます。

• [--max-items] (整数) – コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。

• [--starting-token] (文字列) – ページ分割を始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。

• --launch-template-ids (list) "string" "string" — 起動テンプレートの ID のリスト。

• --launch-template-names (list) "string" "string" — 起動テンプレート名のリスト。

• --page-size — 呼び出しで取得する各ページのサイズ。この値は、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、デバイスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。こうすることで、呼び出しのタイムアウトを防ぐことができます。

• --max-items — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。

• --starting-token — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。

• --endpoint snowballEndpoint – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する」を参照してください。

• --launch-template-id string — 起動テンプレートの ID。

• --launch-template-name string — 起動テンプレート名。

• [--versions (list) "string" "string"] — 削除する 1 つ以上の起動テンプレートバージョンのバージョン番号。

• [--min-version string] — 起動テンプレートバージョンを説明する最小のバージョン番号。

• [--max-version string] — 起動テンプレートバージョンを説明する最大のバージョン番号。

• --page-size — 呼び出しで取得する各ページのサイズ。この値は、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、デバイスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。こうすることで、呼び出しのタイムアウトを防ぐことができます。

• --max-items — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。

• --starting-token — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。

• --endpoint snowballEndpoint – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する」を参照してください。

• [--group-name value] — セキュリティグループ名。

• [--group-id value] — セキュリティグループの ID。

• [--page-size value] – AWS サービスコールで取得する各ページのサイズ。このサイズは、コマンドの出力で返された項目数には影響を与えません。ページサイズを小さく設定すると、 AWS サービスへの呼び出しが多くなり、各呼び出しで取得する項目が少なくなります。このアプローチは、 AWS サービス呼び出しがタイムアウトするのを防ぐのに役立ちます。使用例については、AWS Command Line Interface ユーザーガイドのページ割りを参照してください。

• [--max-items value] — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。 AWS CLIの範囲外で NextToken レスポンス要素を直接使用しないでください。使用例については、AWS Command Line Interface ユーザーガイドのページ割りを参照してください。

• [--starting-token value] — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。使用例については、AWS Command Line Interface ユーザーガイドのページ割りを参照してください。

• launch-template

• resource-id

• resource-type – image または instance

• キー

• value

• [--max-items value] — コマンドの出力で返される項目の総数。使用可能な項目の総数が指定された値を上回る場合、コマンドの出力で NextToken が提供されます。ページ分割を再開するには、後続コマンドの starting-token 引数で NextToken 値を指定します。

• [--starting-token value] — ページ割りを始める場所を指定するトークン。このトークンは、以前に切り詰められたレスポンスからの NextToken 値です。

• [--volume-ids value] — 1 つ以上のボリュームの ID。

• [--device value] — デバイス名。

• [--instance-id] — ターゲットの Amazon EC2 インスタンスの ID。

• --volume-id value — ボリュームの ID。

• --public-ip — インスタンスからの関連付けを解除する仮想 IP アドレス。

• --instance-id – 単一の sbe インスタンスの ID。

• --endpoint snowballEndpoint – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する」を参照してください。

• --launch-template-id string — 起動テンプレートの ID。

• --launch-template-name string — 起動テンプレート名。

• --default-version string — デフォルトバージョンとして設定された起動テンプレートのバージョン番号。

• --endpoint snowballEndpoint – Amazon EC2 互換 API オペレーションを使用して、コンピューティングインスタンスをプログラムで管理できるようにする値。詳細については、「Snowball Edge のエンドポイントとして EC2-compatible AWS CLI エンドポイントを指定する」を参照してください。

• instanceInitiatedShutdownBehavior

• userData

• [--group-id value] — セキュリティグループの ID

• [--ip-permissions value] — IP アクセス許可の 1 つ以上のセット。

• [--group-name value] — セキュリティグループ名。

• [--group-id value] — セキュリティグループの ID。

• [--ip-permissions value] — IP アクセス許可の 1 つ以上のセット。

• [--protocol value] IP プロトコル。指定できる値は tcp、udp、および icmp です。「すべてのプロトコル」が指定されている場合を除き、--port 引数は必須です (-1)。

• [--port value] — TCP または UDP 用に許可するポートの範囲。単一の整数または範囲 (最小/最大)。

  ICMP の場合、1 つの整数または範囲 (type-code) です。この場合、type は ICMP タイプ番号を表し、code は ICMP コード番号を表します。-1 の値は、すべての ICMP タイプのすべての ICMP コードを示します。type だけの -1 の値は、特定の ICMP タイプのすべての ICMP コードを示します。

• [--cidr value] — CIDR IP の範囲。

• [--block-device-mappings (list)] — ブロックデバイスマッピングのエントリ。パラメータ DeleteOnTermination、VolumeSize、および VolumeType がサポートされています。ブートボリュームのタイプは sbg1 である必要があります。

  このコマンドの JSON 構文は次のとおりです。

  {
     "DeviceName": "/dev/sdh",
     "Ebs": 
     {
        "DeleteOnTermination": true|false,
        "VolumeSize": 100,
        "VolumeType": "sbp1"|"sbg1"
     }
  }                                      

• --count — 起動するインスタンスの数。単一の数字が指定されている場合は、起動する最小値と見なされます (デフォルトは 1)。min:max の形式で範囲が指定されている場合、最初の数字は起動するインスタンスの最小数と解釈され、2 番目は起動するインスタンスの最大数として解釈されます。

• --image-id — describe-images を呼び出して取得できる、AMI の Snowball AMI ID。インスタンスを起動するには、AMI が必要です。

• --InstanceInitiatedShutdownBehavior — デフォルトでは、インスタンスから (shutdown や poweroff などのコマンドを使用して) シャットダウンを開始すると、インスタンスが停止します。この動作を変更して、インスタンスの停止ではなく終了させることができます。パラメータ stop および terminate がサポートされています。デフォルト: stop。詳細については、Amazon EC2 Linux インスタンス用ユーザーガイドのインスタンスによって開始されるシャットダウン動作の変更を参照してください。

• --instance-type – sbe インスタンスタイプ。

• --launch-template structure — インスタンスの起動に使用する起動テンプレート。run-instances コマンドで指定したパラメータはすべて、起動テンプレート内の同じパラメータを上書きします。起動テンプレートの名前または ID のいずれかを指定できますが、両方を指定することはできません。

  {
     "LaunchTemplateId": "string",
     "LaunchTemplateName": "string",
     "Version": "string"
  }                                

• --security-group-ids — 1 つ以上のセキュリティグループの ID。CreateSecurityGroup を使用してセキュリティグループを作成できます。値を指定しない場合、デフォルトのセキュリティグループの ID が作成したインスタンスに割り当てられます。

• --tag-specifications — 起動中にリソースに適用されるタグ。起動時にのみインスタンスにタグ付けできます。指定されたタグは、起動時に作成されたすべてのインスタンスに適用されます。作成後のリソースにタグを付けるには、create-tags を使用します。

• --user-data — インスタンスで使用可能なユーザーデータ。を使用している場合は AWS CLI、base64 エンコードが自動的に実行され、ファイルからテキストをロードできます。それ以外の場合は、base64 でエンコードされたテキストを指定する必要があります。

• --key-name (文字列) — キーペア名。キーペアは、CreateKeyPair または ImportKeyPair を使用して作成できます。。

  警告

  キーペアを指定しない場合、ユーザーが別の方法でログインすることを許可する設定の AMI を選択した場合を除き、インスタンスに接続することはできません。

• --instance-ids – デバイスで停止した 1 つ以上の sbe インスタンスの ID。

• --instance-ids – デバイスで停止する 1 つ以上の sbe インスタンスの ID。

• --instance-ids — デバイスで終了する 1 つ以上の sbe インスタンスの ID。これらのインスタンスに保存されたすべての関連するデータは失われます。

• —key-name (文字列) — キーペアの一意の名前。

  制約: 最大 255 字の ASCII 文字。

• [--tag-specifications] (リスト) — 新しいキーペアに適用するタグ。

• —key-name (文字列) — キーペアの一意の名前。

  制約: 最大 255 字の ASCII 文字。

• --public-key-material (blob) — 公開キー。API コールの場合、テキストは base64 でエンコードされている必要があります。コマンドラインツールでは、base64 エンコーディングが自動的に実行されます。

• [--tag-specifications] (リスト) — 新しいキーペアに適用するタグ。

[--filters] (リスト) — フィルター。

• key-pair-id — キーペアの ID。

• key-name — キーペア名。

• tag-key — リソースに割り当てられたタグのキー。このフィルターを使用して、タグの値に関係なく、特定のキーでタグが割り当てられているすべてのリソースを検索します。

• [--tag-specifications] (リスト) — 新しいキーペアに適用するタグ。

• tag :key — リソースに割り当てられたタグのキーと値の組み合わせ。フィルター名にタグキーを使用し、タグ値をフィルター値として使用します。例えば、キー Owner と値 Team A のタグを持つすべてのリソースを検索するには、tag:Owner のフィルター名と Team A のフィルター値を指定します。

• [--key-name] (文字列) — キーペア名。

• [--key-pair-id] (文字列) — キーペアの ID。

• Device

• InstanceId

• VolumeId

• SnapshotId

• Size

• VolumeType

• TagSpecification.N

• ImageId

• InstanceType

• SecurityGroupIds

• TagSpecifications

• UserData

• AMI

• Instance

• Launch template

• Security group

• VolumeId

• instanceType

• userData

• resource-id

• resource-type — AMI あるいはコンピューティングインスタンスのみ

• key

• value

• MaxResults

• NextToken

• VolumeId.N

• Device

• InstanceId

• VolumeId