Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

create-disk

Описание

Создаёт диск блочного хранилища, который можно подключить к экземпляру Amazon Lightsail в той же зоне доступности (us-east-2a).

Операция create disk поддерживает контроль доступа на основе тегов через теги запроса. Дополнительную информацию см. в руководстве разработчика Amazon Lightsail.

См. также: AWS API Documentation

Синтаксис

  create-disk
--disk-name <value>
--availability-zone <value>
--size-in-gb <value>
[--tags <value>]
[--add-ons <value>]
[--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]

Параметры

--disk-name (строка)

Уникальное имя диска Lightsail (my-disk).

--availability-zone (строка)

Зона доступности, в которой вы хотите создать диск (us-east-2a). Используйте ту же зону доступности, что и экземпляр Lightsail, к которому вы хотите подключить диск.

Используйте операцию get regions для отображения зон доступности, в которых Lightsail в настоящее время доступен.

--size-in-gb (целое число)

Размер диска в ГБ (32).

--tags (список)

Ключи тегов и необязательные значения, которые необходимо добавить к ресурсу во время создания.

Используйте действие TagResource, чтобы добавить теги к ресурсу после его создания.

(структура)

Описание ключа тега и необязательного значения, назначенного ресурсу Amazon Lightsail.

Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.

key -> (строка)

Ключ тега.

Ограничения: Ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

value -> (строка)

Значение тега.

Ограничения: Значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @

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

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--add-ons (список)

Массив объектов, представляющих дополнения для включения для нового диска.

(структура)

Описание запроса на включение, изменение или отключение дополнения для ресурса Amazon Lightsail.

Примечание

Включение дополнений может повлечь дополнительные расходы. Дополнительную информацию см. на странице цен Lightsail.

addOnType -> (строка)

Тип дополнения.

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

Объект, представляющий дополнительные параметры при включении или изменении дополнения автоматического создания моментальных снимков.

snapshotTimeOfDay -> (строка)

Ежедневное время создания моментального снимка.

Ограничения:

  • Должен быть в формате HH:00 и с часовым шагом.
  • Указано в координированном всемирном времени (UTC).
  • Моментальный снимок будет автоматически создан между указанным временем и в течение 45 минут после него.

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

Объект, представляющий дополнительные параметры при включении или изменении дополнения StopInstanceOnIdle.

Предупреждение

Этот объект применим только к ресурсам Lightsail for Research.

threshold -> (строка)

Значение для сравнения с продолжительностью.

duration -> (строка)

Продолжительность простоя в минутах, после которой ваш виртуальный компьютер автоматически остановится.

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

addOnType=string,autoSnapshotAddOnRequest={snapshotTimeOfDay=string},stopInstanceOnIdleRequest={threshold=string,duration=string} ...

Синтаксис JSON:

[
  {
    "addOnType": "AutoSnapshot"|"StopInstanceOnIdle",
    "autoSnapshotAddOnRequest": {
      "snapshotTimeOfDay": "string"
    },
    "stopInstanceOnIdleRequest": {
      "threshold": "string",
      "duration": "string"
    }
  }
  ...
]

--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
  • text
  • таблица
  • 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 V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла напрямую независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

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

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

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

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

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

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

Примеры

Примечание

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

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

Чтобы создать диск блочного хранилища

Следующий пример create-disk создаёт диск блочного хранилища Disk-1 в указанном регионе AWS и зоне доступности с 32 ГБ объёма.

aws lightsail create-disk \
    --disk-name Disk-1 \
    --availability-zone us-west-2a \
    --size-in-gb 32

Вывод:

{
    "operations": [
        {
            "id": "1c85e2ec-86ba-4697-b936-77f4d3dc013a",
            "resourceName": "Disk-1",
            "resourceType": "Disk",
            "createdAt": 1569449220.36,
            "location": {
                "availabilityZone": "us-west-2a",
                "regionName": "us-west-2"
            },
            "isTerminal": false,
            "operationType": "CreateDisk",
            "status": "Started",
            "statusChangedAt": 1569449220.588
        }
    ]
}

Вывод

operations -> (список)

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

(структура)

Описание операции API.

id -> (строка)

Идентификатор операции.

resourceName -> (строка)

Имя ресурса.

resourceType -> (строка)

Тип ресурса.

createdAt -> (отметка времени)

Отметка времени инициирования операции (1479816991.349).

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

Регион и зона доступности Amazon Web Services.

availabilityZone -> (строка)

Зона доступности. Следует формату us-east-2a (регистрозависимый).

regionName -> (строка)

Имя региона Amazon Web Services.

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

Логическое значение, указывающее, является ли операция конечной.

operationDetails -> (строка)

Подробности об операции (Debian-1GB-Ohio-1).

operationType -> (строка)

Тип операции.

status -> (строка)

Статус операции.

statusChangedAt -> (отметка времени)

Отметка времени изменения статуса (1479816991.349).

errorCode -> (строка)

Код ошибки.

errorDetails -> (строка)

Подробности об ошибке.

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

Spec-Zone.ru

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