标记竞价型实例请求

要对您的竞价型实例请求进行分类和管理，您可使用自定义元数据标记它们。您可以在创建竞价型实例请求时或之后为其分配标签。您可以使用 Amazon EC2 控制台或命令行工具分配标签。

在标记竞价型实例请求时，不会自动标记由竞价型实例请求启动的实例和卷。您需要明确标记由竞价型实例请求启动的实例和卷。您可以在启动期间或之后为竞价型实例和卷分配标签。

有关标签的工作原理的更多信息，请参阅标记 Amazon EC2 资源。

前提条件

授予用户标记资源的权限。有关 IAM policies 和示例策略的更多信息，请参阅示例：标记资源。

您创建的 IAM policy 由您用于创建竞价型实例请求的方法决定。

• 如果您使用启动实例向导或 run-instances 请求 Spot 实例，请参阅To grant a user the permission to tag resources when using the launch instance wizard or run-instances。

• 如果您使用 request-spot-instances 命令请求竞价型实例，请参阅 To grant a user the permission to tag resources when using request-spot-instances。

在使用启动实例向导或 run-instances 时向用户授予资源标记权限

创建包含以下内容的 IAM policy：

• ec2:RunInstances 操作。这将授予用户授予启动实例的权限。

• 对于 Resource，请指定 spot-instances-request。这允许用户创建竞价型实例请求，以请求竞价型实例。

• ec2:CreateTags 操作。这将授予用户创建标签的权限。

• 对于 Resource，请指定 *。这将允许用户标记在实例启动期间创建的所有资源。

JSON

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowLaunchInstances",
            "Effect": "Allow",
            "Action": [
                "ec2:RunInstances"
            ],
            "Resource": [
                "arn:aws:ec2:us-east-1::image/*",
                "arn:aws:ec2:us-east-1:*:subnet/*",
                "arn:aws:ec2:us-east-1:*:network-interface/*",
                "arn:aws:ec2:us-east-1:*:security-group/*",
                "arn:aws:ec2:us-east-1:*:key-pair/*",
                "arn:aws:ec2:us-east-1:*:volume/*",
                "arn:aws:ec2:us-east-1:*:instance/*",
                "arn:aws:ec2:us-east-1:*:spot-instances-request/*"
            ]
        },
        {
            "Sid": "TagSpotInstanceRequests",
            "Effect": "Allow",
            "Action": "ec2:CreateTags",
            "Resource": "*"
        }
    ]
}

使用 RunInstances 操作创建竞价型实例请求，并在创建时标记竞价型实例请求时，您需要了解 Amazon EC2 如何评估 RunInstances 语句（在 IAM 策略中评估）中的 spot-instances-request 资源，如下所示：

• 如果您在创建时未标记竞价型实例请求，则 Amazon EC2 不会在 RunInstances 语句中评估 spot-instances-request 资源。

• 如果您在创建时标记竞价型实例请求，则 Amazon EC2 会在 RunInstances 语句中评估 spot-instances-request 资源。

因此，对于 spot-instances-request 资源，以下规则适用于 IAM policy：

• 如果您使用 RunInstances 创建竞价型实例请求，并且您不打算在创建时标记竞价型实例请求，则无需明确允许 spot-instances-request 资源；调用将成功。

• 如果您使用 RunInstances 创建竞价型实例请求并打算在创建时标记竞价型实例请求，则必须在 RunInstances 允许语句中包含 spot-instances-request 资源，否则调用将失败。

• 如果您使用 RunInstances 创建竞价型实例请求并打算在创建时标记竞价型实例请求，则必须在 CreateTags 允许语句中指定 spot-instances-request 资源或包括 * 通配符，否则调用将失败。

有关示例 IAM policy（包括竞价型实例请求不支持的策略），请参阅 使用竞价型实例。

在使用 request-spot-instances 时向用户授予资源标记权限

创建包含以下内容的 IAM policy：

• ec2:RequestSpotInstances 操作。这将授予用户创建竞价型实例请求的权限。

• ec2:CreateTags 操作。这将授予用户创建标签的权限。

• 对于 Resource，请指定 spot-instances-request。这将允许用户仅标记竞价型实例请求。

JSON

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "TagSpotInstanceRequest",
            "Effect": "Allow",
            "Action": [
                "ec2:RequestSpotInstances",
                "ec2:CreateTags"
            ],
            "Resource": "arn:aws:ec2:us-east-1:111122223333:spot-instances-request/*"
        }
    ]
}

标记新的竞价型实例请求

在 AWS CLI 和 PowerShell 示例中，按如下方式配置竞价型实例请求：

• 对于 ResourceType，请指定 spot-instances-request。如果指定其他值，则竞价型实例请求将失败。

• 对于 Tags，请指定键值对。您可以指定多个键值对。

Console

标记新竞价型实例请求

1. 按照管理您的竞价型实例过程操作。

2. 要添加标签，请在添加标签页上，选择添加标签，然后输入标签的键和值。为每个附加标签选择添加其他标签。

   对于每个标签，您可以使用相同标签来标记竞价型实例请求、竞价型实例和卷。要标记所有这三个项，请确保已选定 Instances (实例)、Volumes (卷)和 Spot Instance Requests (Spot 实例请求)。要仅标记其中的一个或两个项，请确保已选定要标记的资源，并清除其他资源。

3. 填写必填字段以创建 Spot 实例请求，然后选择 Launch (启动)。有关更多信息，请参阅 管理您的竞价型实例。

AWS CLI

标记新竞价型实例请求

使用 request-spot-instances 命令和 --tag-specification 选项。

标签规范向竞价型实例请求添加两个标签：Environment=Production 和 Cost-Center=123。

aws ec2 request-spot-instances \
    --instance-count 5 \
    --type "one-time" \
    --launch-specification file://specification.json \
    --tag-specification 'ResourceType=spot-instances-request,Tags=[{Key=Environment,Value=Production},{Key=Cost-Center,Value=123}]'

PowerShell

标记新竞价型实例请求

使用 Request-EC2SpotInstance cmdlet 和 -TagSpecification 参数。

-TagSpecification $tagspec

标签规范定义如下。它向竞价型实例请求添加两个标签：Environment=Production 和 Cost-Center=123。

$tag1 = @{Key="Environment"; Value="Production"}
$tag2 = @{Key="Cost-Center"; Value="123"}
$tagspec = New-Object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "spot-instances-request"
$tagspec.Tags = @($tag1,$tag2)

标记现有竞价型实例请求

Console

标记现有竞价型实例请求

创建竞价型实例请求后，您可以使用控制台向竞价型实例请求添加标签。

1. 通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。

2. 在导航窗格中，请选择 Spot Requests。

3. 选择您的竞价型实例请求。

4. 选择 Tags (标签) 选项卡，然后选择 Create Tag (创建标签)。

使用控制台标记现有的竞价型实例

在竞价型实例请求启动竞价型实例后，您可以使用控制台向实例添加标签。有关更多信息，请参阅 使用控制台添加标签。

AWS CLI

标记现有的竞价型实例请求或竞价型实例

使用 create-tags 命令标记现有的资源。在以下示例中，使用 purpose=test 标记现有竞价型实例请求和竞价型实例。

aws ec2 create-tags \
    --resources sir-0e54a519c9EXAMPLE i-1234567890abcdef0 \
    --tags Key=purpose,Value=test

PowerShell

标记现有的竞价型实例请求或竞价型实例

使用 New-EC2Tag cmdlet。以下示例将标签 purpose=test 添加到现有竞价型实例请求和竞价型实例。

New-EC2Tag `
    -Resource sir-0e54a519c9EXAMPLE, i-1234567890abcdef0 `
    -Tag @{Key="purpose"; Value="test"}

查看竞价型实例请求标记

Console

查看竞价型实例请求标签

1. 通过以下网址打开 Amazon EC2 控制台：https://console.aws.amazon.com/ec2/。

2. 在导航窗格中，请选择 Spot Requests。

3. 选择您的 Spot 实例请求并选择 Tags (标签) 选项卡。

AWS CLI

描述竞价型实例请求标记

使用 describe-spot-instance-requests 命令可查看指定的 Spot 实例请求的配置，其中包括为请求指定的任何标签。

aws ec2 describe-spot-instance-requests \
    --spot-instance-request-ids sir-0e54a519c9EXAMPLE \
    --query "SpotInstanceRequests[*].Tags"

下面是示例输出。

[
    [
        {
            "Key": "Environment",
            "Value": "Production"
        },
        {
            "Key": "Department",
            "Value": "101"
        }
    ]
]

PowerShell

描述竞价型实例请求标记

使用 Get-EC2SpotInstanceRequest cmdlet。

(Get-EC2SpotInstanceRequest `
    -SpotInstanceRequestId sir-0e54a519c9EXAMPLE).Tags

下面是示例输出。

Key         Value
---         -----
Environment Production
Department  101