describe-spot-instance-requests

Описание

Описывает указанные запросы на Spot-инстансы.

Вы можете использовать DescribeSpotInstanceRequests для поиска запущенного Spot-инстанса, проверив ответ. Если состояние Spot-инстанса равно fulfilled, идентификатор инстанса отображается в ответе и содержит идентификатор инстанса. В качестве альтернативы вы можете использовать DescribeInstances с фильтром, чтобы найти инстансы, где жизненный цикл инстанса равен spot.

Рекомендуется установить MaxResults со значением от 5 до 1000, чтобы ограничить количество возвращаемых элементов. Это страницирует вывод, что делает список более управляемым и быстрее возвращает элементы. Если список элементов превышает ваше значение MaxResults, то возвращается это количество элементов вместе со значением NextToken, которое можно передать в последующий запрос DescribeSpotInstanceRequests для получения оставшихся элементов.

Запросы на Spot-инстансы удаляются через четыре часа после отмены и завершения работы их инстансов.

См. также: Документация AWS API

describe-spot-instance-requests является страницированной операцией. Для получения всего набора результатов могут быть вызваны несколько API-вызовов. Вы можете отключить страницирование, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе, содержащем страницу, аргумент --query должен извлекать данные из результатов следующих выражений запроса: SpotInstanceRequests

Синтаксис

  describe-spot-instance-requests
[--dry-run | --no-dry-run]
[--spot-instance-request-ids <value>]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--dry-run | --no-dry-run (boolean)

--spot-instance-request-ids (список)

Синтаксис:

"string" "string" ...

--filters (список)

Сокращенный синтаксис:

Name=string,Values=string,string ...

Синтаксис JSON:

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

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы указаны в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет принята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

--page-size (целое число)

--max-items (целое число)

--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса API. При указании без значения или со значением input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример ввода YAML, который можно использовать с --cli-input-yaml. Если указано значение output, он проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-каркас не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-каркасе.

Глобальные параметры

--debug (boolean)

Включить отладку логирования.

--endpoint-url (string)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

• json
• text
• table
• yaml
• yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла аутентификации.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/отключить вывод цвета.

• on
• off
• auto

--no-sign-request (boolean)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент указан.

--ca-bundle (string)

Файл с набором сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строки base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, сопоставляемого с двоичным блоком fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Пример 1: Описание запроса на запуск экземпляра Spot Instance

Следующий describe-spot-instance-requests пример описывает указанный запрос на запуск экземпляра Spot Instance.

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: Описание запросов на запуск экземпляров Spot Instance на основе фильтров

Следующий describe-spot-instance-requests пример использует фильтры для ограничения результатов запросами на запуск экземпляров Spot Instance с указанным типом экземпляра в указанной зоне доступности. В примере используется параметр --query для отображения только идентификаторов экземпляров.

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.

Пример 3: Описание запросов на запуск экземпляров Spot Instance на основе тегов

Следующий describe-spot-instance-requests пример использует фильтры тегов для ограничения результатов запросами на запуск экземпляров Spot Instance, имеющими тег cost-center=cc123.

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

Пример вывода для describe-spot-instance-requests см. в Примере 1.

Дополнительные примеры использования фильтров тегов см. в разделе «Работа с тегами» в Руководстве пользователя Amazon EC2.

Вывод

SpotInstanceRequests -> (список)

NextToken -> (строка)