Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

start-instances

Описание

Запускает виртуальную машину (ВМ) Amazon EC2 с поддержкой томов Amazon EBS, которую вы ранее остановили.

Виртуальные машины, использующие тома Amazon EBS в качестве корневых томов, могут быть быстро остановлены и запущены. При остановке ВМ освобождаются вычислительные ресурсы, и вы не оплачиваете использование ВМ. Однако ваш корневой том Amazon EBS сохраняется и продолжает хранить ваши данные, и вы платите за использование тома Amazon EBS. Вы можете перезапустить ВМ в любое время. Каждый раз при запуске ВМ Amazon EC2 взимает минимальную плату за использование ВМ в течение одной минуты, а затем взимает плату за каждую секунду использования.

Прежде чем остановить ВМ, убедитесь, что она находится в состоянии, позволяющем ее перезапуск. Остановка ВМ не сохраняет данные, хранящиеся в оперативной памяти.

Выполнение этой операции над ВМ, использующей хранилище экземпляра в качестве корневого устройства, возвращает ошибку.

Если вы пытаетесь запустить экземпляр T3 с host арендой и опцией кредитов процессора unlimited, запрос завершится неудачно. Опция кредитов процессора unlimited не поддерживается на выделенных хостах. Перед запуском экземпляра измените его опцию кредитов процессора на standard или измените его арендную модель на default или dedicated.

Дополнительную информацию см. в руководстве пользователя Amazon EC2 по остановке и запуску экземпляров Amazon EC2.

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

Синтаксис

  start-instances
--instance-ids <value>
[--additional-info <value>]
[--dry-run | --no-dry-run]
[--cli-input-json | --cli-input-yaml]
[--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]

Параметры

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

Идентификаторы экземпляров.

(строка)

Синтаксис:

"string" "string" ...

--additional-info (строка)

Зарезервировано.

--dry-run | --no-dry-run (логическое значение)

Проверяет наличие необходимых разрешений для операции без фактического выполнения запроса и предоставляет ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation. В противном случае — UnauthorizedOperation.

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

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

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

--debug (логическое значение)

Включить отладку.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включить
  • отключить
  • автоматически

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

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

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить вывод пагинатора CLI.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы с AWS CLI в руководстве пользователя AWS CLI.

За исключением случаев, когда указано иное, все примеры используют правила цитирования, аналогичные правилам Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.

Запуск экземпляра Amazon EC2

В этом примере запускается указанный экземпляр Amazon EC2 с поддержкой томов Amazon EBS.

Команда:

aws ec2 start-instances --instance-ids i-1234567890abcdef0

Вывод:

{
    "StartingInstances": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "CurrentState": {
                "Code": 0,
                "Name": "pending"
            },
            "PreviousState": {
                "Code": 80,
                "Name": "stopped"
            }
        }
    ]
}

Дополнительную информацию см. в руководстве пользователя Amazon Elastic Compute Cloud по остановке и запуску экземпляра.

Вывод

StartingInstances -> (список)

Информация о запущенных экземплярах.

(структура)

Описание изменения состояния экземпляра.

InstanceId -> (строка)

Идентификатор экземпляра.

CurrentState -> (структура)

Текущее состояние экземпляра.

Code -> (целое число)

Состояние экземпляра в виде 16-битного беззнакового целого числа.

Высокий байт содержит все биты от 28 до (216) - 1, что соответствует десятичным значениям от 256 до 65 535. Эти числовые значения используются для внутренних целей и должны быть проигнорированы.

Низкий байт содержит все биты от 20 до (28) - 1, что соответствует десятичным значениям от 0 до 255.

Допустимые значения для instance-state-code будут находиться в диапазоне низкого байта и равны:

  • 0 : pending
  • 16 : running
  • 32 : shutting-down
  • 48 : terminated
  • 64 : stopping
  • 80 : stopped

Высокое байтовое значение можно игнорировать, обнулив все биты выше 28 или 256 в десятичной форме.

Name -> (строка)

Текущее состояние экземпляра.

PreviousState -> (структура)

Предыдущее состояние экземпляра.

Code -> (целое число)

Состояние экземпляра в виде 16-битного беззнакового целого числа.

Высокий байт содержит все биты от 28 до (216) - 1, что соответствует десятичным значениям от 256 до 65 535. Эти числовые значения используются для внутренних целей и должны быть проигнорированы.

Низкий байт содержит все биты от 20 до (28) - 1, что соответствует десятичным значениям от 0 до 255.

Допустимые значения для instance-state-code будут находиться в диапазоне низкого байта и равны:

  • 0 : pending
  • 16 : running
  • 32 : shutting-down
  • 48 : terminated
  • 64 : stopping
  • 80 : stopped

Высокое байтовое значение можно игнорировать, обнулив все биты выше 28 или 256 в десятичной форме.

Name -> (строка)

Текущее состояние экземпляра.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API