CLI で DescribeSpotInstanceRequests を使用する

次のサンプルコードは、DescribeSpotInstanceRequests を使用する方法を説明しています。

CLI

AWS CLI

例 1: スポットインスタンスリクエストを記述するには

次の describe-spot-instance-requests の例では、指定したスポットインスタンスについて説明します。

aws ec2 describe-spot-instance-requests \
    --spot-instance-request-ids sir-08b93456

出力:

{
    "SpotInstanceRequests": [
        {
            "CreateTime": "2018-04-30T18:14:55.000Z",
            "InstanceId": "i-1234567890abcdef1",
            "LaunchSpecification": {
                "InstanceType": "t2.micro",
                "ImageId": "ami-003634241a8fcdec0",
                "KeyName": "my-key-pair",
                "SecurityGroups": [
                    {
                        "GroupName": "default",
                        "GroupId": "sg-e38f24a7"
                    }
                ],
                "BlockDeviceMappings": [
                    {
                        "DeviceName": "/dev/sda1",
                        "Ebs": {
                            "DeleteOnTermination": true,
                            "SnapshotId": "snap-0e54a519c999adbbd",
                            "VolumeSize": 8,
                            "VolumeType": "standard",
                            "Encrypted": false
                        }
                    }
                ],
                "NetworkInterfaces": [
                    {
                        "DeleteOnTermination": true,
                        "DeviceIndex": 0,
                        "SubnetId": "subnet-049df61146c4d7901"
                    }
                ],
                "Placement": {
                    "AvailabilityZone": "us-east-2b",
                    "Tenancy": "default"
                },
                "Monitoring": {
                    "Enabled": false
                }
            },
            "LaunchedAvailabilityZone": "us-east-2b",
            "ProductDescription": "Linux/UNIX",
            "SpotInstanceRequestId": "sir-08b93456",
            "SpotPrice": "0.010000"
            "State": "active",
            "Status": {
                "Code": "fulfilled",
                "Message": "Your Spot request is fulfilled.",
                "UpdateTime": "2018-04-30T18:16:21.000Z"
            },
            "Tags": [],
            "Type": "one-time",
            "InstanceInterruptionBehavior": "terminate"
        }
    ]
}

例 2: フィルターに基づいてスポットインスタンスリクエストを記述するには

次の describe-spot-instance-requests の例では、フィルターを使用して、指定したアベイラビリティーゾーンにある指定したインスタントタイプを持つスポットインスタンスリクエストに結果の範囲を絞り込みます。この例では、--query パラメータを使用してインスタンス ID のみを表示します。

aws ec2 describe-spot-instance-requests \
    --filters Name=launch.instance-type,Values=m3.medium Name=launched-availability-zone,Values=us-east-2a \
    --query "SpotInstanceRequests[*].[InstanceId]" \
    --output text

出力:

i-057750d42936e468a
i-001efd250faaa6ffa
i-027552a73f021f3bd
...

フィルターの使用の詳細については、「Amazon Elastic Compute Cloud ユーザーガイド」の「Listing and filtering your resources」を参照してください。

例 3: タグに基づいてスポットインスタンスリクエストを記述するには

次の describe-spot-instance-requests の例では、タグフィルターを使用して、タグ cost-center=cc123 を含むスポットインスタンスリクエストに結果の範囲を絞り込みます。

aws ec2 describe-spot-instance-requests \
    --filters Name=tag:cost-center,Values=cc123

describe-spot-instance-requests の出力例については、例 1 を参照してください。

タグフィルターを使用するその他の例については、「Amazon EC2 ユーザーガイド」でタグの使用方法を参照してください。

• API の詳細については、「AWS CLI コマンドリファレンス」の「DescribeSpotInstanceRequests」を参照してください。

PowerShell

Tools for PowerShell

例 1: この例では、指定されたスポットインスタンスリクエストを記述します。

Get-EC2SpotInstanceRequest -SpotInstanceRequestId sir-12345678

出力:

ActualBlockHourlyPrice   :
AvailabilityZoneGroup    :
BlockDurationMinutes     : 0
CreateTime               : 4/8/2015 2:51:33 PM
Fault                    :
InstanceId               : i-12345678
LaunchedAvailabilityZone : us-west-2b
LaunchGroup              :
LaunchSpecification      : Amazon.EC2.Model.LaunchSpecification
ProductDescription       : Linux/UNIX
SpotInstanceRequestId    : sir-12345678
SpotPrice                : 0.020000
State                    : active
Status                   : Amazon.EC2.Model.SpotInstanceStatus
Tags                     : {Name}
Type                     : one-time

例 2: この例では、すべてのスポットインスタンスリクエストについて説明します。

Get-EC2SpotInstanceRequest

• API の詳細については、AWS Tools for PowerShell 「 コマンドレットリファレンス」のDescribeSpotInstanceRequests」を参照してください。