在 Snowball EC2 Edge 上使用与亚马逊兼容的终端节点

• --instance-id：单个 sbe 实例的 ID。

• --public-ip：要用来访问您的实例的虚拟 IP 地址。

• --device value：设备名称。

• --instance-id — 与亚马逊 EC2兼容的目标实例的 ID。

• ---volume-id value：EBS 卷的 ID。

• --group-id value：安全组的 ID。

• [--ip-permissions value]：一个或多个 IP 权限集。

• [--group-name value]：安全组的名称。

• [--group-id value]：安全组的 ID

• [--ip-permissions value]：一个或多个 IP 权限集。

• [--protocol value] IP 协议。可能的值为 tcp、udp 和 icmp。--port 参数是必填项，除非“所有协议”值指定为（-1）。

• [--port value]：对于 TCP 或 UDP，允许的端口范围。此值可以是单个整数或范围（最小值–最大值）。

  对于 ICMP，为单个整数或范围（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 — 一个允许您使用与亚马逊 EC2兼容的 API 操作以编程方式管理计算实例的值。有关更多信息，请参阅 将 EC2兼容的端点指定为 Snowball AWS CLI Edge 上的端点。

• --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 — 一个允许您使用与亚马逊 EC2兼容的 API 操作以编程方式管理计算实例的值。有关更多信息，请参阅 将 EC2兼容的端点指定为 Snowball AWS CLI Edge 上的端点。

• AMI

• 实例

• 启动模板

• 安全组

• 密钥对

• --group-name value：安全组的名称。

• --description value：安全组的描述。此仅为信息性。此值最长可达 255 个字符。

• [--sizevalue] — 中的卷的大小 GiBs，可以从 1 GiB 到 1 TB ( GiBs1000) 不等。

• [--snapshot-id value]：从中创建卷的快照。

• [--volume-type value]：卷类型。如果未指定值，则默认值为 sbg1。可能的值包括：

  • 对于磁性介质卷为 sbg1

  • 对于 SSD 卷为 sbp1

• [--tag-specification value]：在创建期间应用到卷的标签列表。

• --launch-template-id string — 启动模板的 ID。

• --launch-template-name string — 启动模板的名称。

• --endpoint snowballEndpoint — 一个允许您使用与亚马逊 EC2兼容的 API 操作以编程方式管理计算实例的值。有关更多信息，请参阅 将 EC2兼容的端点指定为 Snowball AWS CLI Edge 上的端点。

• --launch-template-id string — 启动模板的 ID。

• --launch-template-name string — 启动模板的名称。

• --versions (list) "string" "string" ：要删除的一个或多个启动模板版本的版本号。

• --endpoint snowballEndpoint — 一个允许您使用与亚马逊 EC2兼容的 API 操作以编程方式管理计算实例的值。有关更多信息，请参阅 将 EC2兼容的端点指定为 Snowball AWS CLI Edge 上的端点。

• --group-name value：安全组的名称。

• --description value：安全组的描述。此仅为信息性。此值最长可达 255 个字符。

• --volume-id value：卷的 ID。

• --public-ips：与您的实例关联的一个或多个虚拟 IP 地址。

• --image-id：AMI 的 Snowball AMI ID。

• instanceInitiatedShutdownBehavior

• instanceType

• userData

• --instance-id — 设备上已停止的一个或多个sbe实例。 IDs

• --page-size：调用中获取的每个页面的大小。此值不会影响命令的输出中返回的项目数。设置较小的页面大小会导致对设备进行更多调用，每次调用检索的项目数较少。这样做有助于防止调用超时。

• --max-items：命令的输出中要返回的项目总数。如果可用的总项目数超过指定的值，则命令的输出中会提供 NextToken。要恢复分页，请在后续命令的 starting-token 参数中提供 NextToken 值。

• --starting-token：指定从何处开始分页的令牌。此令牌是先前截断的响应中的 NextToken 值。

• 状态检查 — Snow 设备对正在运行的与 Amazon EC2 兼容的实例执行状态检查，以识别硬件和软件问题。

• 实例状态：您可以在实例启动直至实例终止期间管理您的实例。

• [--filters] (list)

  筛选条件。

  • 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：筛选名称为可到达性（passed | failed | initializing | insufficient-data ）的系统状态。

  • system-status.status：实例的状态（ok | impaired | initializing | insufficient-data | not-applicable ）。

• JSON 语法：

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

• [--instance-ids] (list)

  实例 IDs。

  默认：描述您的所有实例。

• [--dry-run|--no-dry-run]（布尔值）

  检查您是否拥有操作所需的权限，但不实际发出请求，并提供错误响应。如果您拥有所需的权限，则错误响应为 DryRunOperation。

  否则为 UnauthorizedOperation。

• [--include-all-instances | --no-include-all-instances]（布尔值）

  如果为 true，则包括所有实例的运行状况。如果为 false，则仅包括正在运行实例的运行状况。

  默认值：false

• [--page-size] (integer)：调用中获取的每个页面的大小。此值不会影响命令的输出中返回的项目数。设置较小的页面大小会导致对设备进行更多调用，每次调用检索的项目数较少。这样做有助于防止调用超时。

• [--max-items] (integer)：命令的输出中要返回的项目总数。如果可用的总项目数超过指定的值，则命令的输出中会提供 NextToken。要恢复分页，请在后续命令的 starting-token 参数中提供 NextToken 值。

• [--starting-token] (string)：用于指定从何处开始分页的令牌。此令牌是先前截断的响应中的 NextToken 值。

• --launch-template-ids （列表）"string" "string"-启动模板列表。 IDs

• --launch-template-names （列表）"string" "string"-启动模板的名称列表。

• --page-size：调用中获取的每个页面的大小。此值不会影响命令的输出中返回的项目数。设置较小的页面大小会导致对设备进行更多调用，每次调用检索的项目数较少。这样做有助于防止调用超时。

• --max-items：命令的输出中要返回的项目总数。如果可用的总项目数超过指定的值，则命令的输出中会提供 NextToken。要恢复分页，请在后续命令的 starting-token 参数中提供 NextToken 值。

• --starting-token：指定从何处开始分页的令牌。此令牌是先前截断的响应中的 NextToken 值。

• --endpoint snowballEndpoint — 一个允许您使用与亚马逊 EC2兼容的 API 操作以编程方式管理计算实例的值。有关更多信息，请参阅 将 EC2兼容的端点指定为 Snowball AWS CLI Edge 上的端点。

• --launch-template-id string — 启动模板的 ID。

• --launch-template-name string — 启动模板的名称。

• [--versions (list) "string" "string"] ：要删除的一个或多个启动模板版本的版本号。

• [--min-version string]：用于描述启动模板版本的最小版本号。

• [--max-version string]：用于描述启动模板版本的最大版本号。

• --page-size：调用中获取的每个页面的大小。此值不会影响命令的输出中返回的项目数。设置较小的页面大小会导致对设备进行更多调用，每次调用检索的项目数较少。这样做有助于防止调用超时。

• --max-items：命令的输出中要返回的项目总数。如果可用的总项目数超过指定的值，则命令的输出中会提供 NextToken。要恢复分页，请在后续命令的 starting-token 参数中提供 NextToken 值。

• --starting-token：指定从何处开始分页的令牌。此令牌是先前截断的响应中的 NextToken 值。

• --endpoint snowballEndpoint — 一个允许您使用与亚马逊 EC2兼容的 API 操作以编程方式管理计算实例的值。有关更多信息，请参阅 将 EC2兼容的端点指定为 Snowball AWS CLI Edge 上的端点。

• [--group-name value]：安全组的名称。

• [--group-id value]：安全组的 ID。

• [--page-sizevalue]-服务调用中要获取的每页的大小。 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-idvalue]-一个或多个卷。 IDs

• [--device value]：设备名称。

• [--instance-id]-目标亚马逊实例的 ID。 EC2

• --volume-id value：卷的 ID。

• --public-ip：您要与实例取消关联的虚拟 IP 地址。

• --instance-id：单个 sbe 实例的 ID。

• --endpoint snowballEndpoint — 一个允许您使用与亚马逊 EC2兼容的 API 操作以编程方式管理计算实例的值。有关更多信息，请参阅 将 EC2兼容的端点指定为 Snowball AWS CLI Edge 上的端点。

• --launch-template-id string — 启动模板的 ID。

• --launch-template-name string — 启动模板的名称。

• --default-version string：设置为默认版本的启动模板版本号。

• --endpoint snowballEndpoint — 一个允许您使用与亚马逊 EC2兼容的 API 操作以编程方式管理计算实例的值。有关更多信息，请参阅 将 EC2兼容的端点指定为 Snowball AWS CLI Edge 上的端点。

• instanceInitiatedShutdownBehavior

• userData

• [--group-id value]：安全组的 ID

• [--ip-permissions value]：一个或多个 IP 权限集。

• [--group-name value]：安全组的名称。

• [--group-id value]：安全组的 ID。

• [--ip-permissions value]：一个或多个 IP 权限集。

• [--protocol value] IP 协议。可能的值为 tcp、udp 和 icmp。--port 参数是必填项，除非“所有协议”值指定为（-1）。

• [--port value]：对于 TCP 或 UDP，允许的端口范围。单个整数或范围（最小值–最大值）。

  对于 ICMP，为单个整数或范围（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 形式提供范围，则第一个数字解释为要启动的最小实例数量，第二个数字解释为要启动的最大实例数量。

• --image-id：AMI 的 Snowball AMI ID，可以通过调用 describe-images 获得。启动实例时需要 AMI。

• --InstanceInitiatedShutdownBehavior — 默认情况下，当您从实例启动关机时（使用诸如关闭或关机之类的命令），实例会停止。您可以更改此行为，以便使其终止。支持 stop 和 terminate 参数。默认为 stop。有关更多信息，请参阅《Amazon Linux 实例 EC2 用户指南》中的更改实例启动的关闭行为。

• --instance-type：sbe 实例类型。

• --launch-template structure：设置为默认版本的启动模板的版本号。您在 run-instances 命令中指定的任何参数都会覆盖启动模板中的相同参数。您可以指定启动模板的名称或 ID，但不能同时指定二者。

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

• --security-group-ids — 一个或多个安全组 IDs。您可以使用创建安全组CreateSecurityGroup。如果未提供任何值，则会将默认安全组的 ID 分配给创建的实例。

• --tag-specifications：要在启动期间应用于资源的标签。只能在启动时标记实例。指定的标签将应用于在启动期间创建的所有实例。要在创建之后标记资源，请使用 create-tags。

• --user-data：提供给实例的用户数据。如果您使用的是 AWS CLI，则会为您执行 base64 编码，您可以从文件加载文本。否则，您必须提供 base64 编码文本。

• --key-name (string)：密钥对的名称。您可以使用 CreateKeyPair 或 ImportKeyPair 创建密钥对。

  警告

  如果您未指定密钥对，则无法连接到实例，除非您选择配置为允许用户以其他方式登录的 AMI。

• --instance-id — 设备上已停止的一个或多个sbe实例。 IDs

• --instance-id — 设备上要停止的一个或多个sbe实例。 IDs

• --instance-id — 设备上要终止的一个或多个sbe实例。 IDs 为这些实例存储的所有关联数据都将丢失。

• --key-name (string)：密钥对的唯一名称。

  约束：最多 255 个 ASCII 字符。

• [--tag-specifications] (list)：要应用于新密钥对的标签。

• --key-name (string)：密钥对的唯一名称。

  约束：最多 255 个 ASCII 字符。

• --public-key-material （blob）-公钥。对于 API 调用，文本必须为 base64 编码。对于命令行工具，会为您执行 base64 编码。

• [--tag-specifications] (list)：要应用于新密钥对的标签。

[--filters] (list)：筛选条件。

• key-pair-id — 密钥对的 ID。

• key-name：密钥对的名称。

• tag-key：资源所分配标签的键。使用此筛选条件查找分配有标签且标签带有特定键的所有资源，无论标签值如何。

• [--tag-specifications] (list)：要应用于新密钥对的标签。

• tag :key：资源所分配标签的键/值组合。使用筛选器名称中的标签键和标签值作为筛选器值。例如，要查找具有键 Owner 和值 Team A 的标签的所有资源，请为筛选器名称指定 tag:Owner，为筛选器值指定 Team A。

• [--key-name] (string)：密钥对的名称。

• [--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