Spec-Zone.ru › AWS CLI v2

[ aws . lightsail ]

создать-снимок-диска

Описание

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

Можно сделать снимок подключенного диска, который используется; однако снимки фиксируют только те данные, которые были записаны на диск в момент выполнения команды снимка. Это может исключить любые данные, кэшированные приложениями или операционной системой. Если можно достаточно долго приостановить все файловые системы на диске для создания снимка, ваш снимок должен быть полным. Тем не менее, если нельзя приостановить все записи файлов на диске, необходимо отсоединить диск внутри экземпляра Lightsail, выполнить команду создания снимка диска, а затем снова подключить диск, чтобы гарантировать последовательный и полный снимок. Вы можете снова подключить и использовать свой диск, пока статус снимка не определён.

Вы также можете использовать эту операцию для создания снимка системного тома экземпляра. Это может потребоваться, например, для восстановления данных из системного тома испорченного экземпляра или для создания резервной копии системного тома, как и для диска блочного хранилища. Чтобы создать снимок системного тома, просто определите параметр instance name при выполнении команды снимка, и будет создан снимок системного тома определённого экземпляра. После того, как снимок будет доступен, вы можете создать диск блочного хранилища из снимка и подключить его к работающему экземпляру, чтобы получить доступ к данным на диске.

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

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

Синтаксис

  create-disk-snapshot
[--disk-name <value>]
--disk-snapshot-name <value>
[--instance-name <value>]
[--tags <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 (строка)

Уникальное имя исходного диска (Disk-Virginia-1).

Примечание

Этот параметр нельзя определять вместе с параметром instance name. Параметры disk name и instance name взаимоисключающие.

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

Имя снимка целевого диска (my-disk-snapshot) на основе исходного диска.

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

Уникальное имя исходного экземпляра (Amazon_Linux-512MB-Virginia-1). При определении этого параметра создается снимок системного тома экземпляра.

Примечание

Этот параметр нельзя определять вместе с параметром disk name. Параметры instance name и disk name взаимоисключающие.

--tags (список)

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

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

(структура)

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

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

key -> (строка)

Ключ тега.

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

value -> (строка)

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

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

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

key=string,value=string ...

JSON-синтаксис:

[
  {
    "key": "string",
    "value": "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
  • текст
  • таблица
  • 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.

Пример 1: Создание снимка диска

Следующий пример create-disk-snapshot создает снимок с именем DiskSnapshot-1 указанного диска блочного хранилища.

aws lightsail create-disk-snapshot \
    --disk-name Disk-1 \
    --disk-snapshot-name DiskSnapshot-1

Вывод:

{
    "operations": [
        {
            "id": "fa74c6d2-03a3-4f42-a7c7-792f124d534b",
            "resourceName": "DiskSnapshot-1",
            "resourceType": "DiskSnapshot",
            "createdAt": 1569625129.739,
            "location": {
                "availabilityZone": "all",
                "regionName": "us-west-2"
            },
            "isTerminal": false,
            "operationDetails": "Disk-1",
            "operationType": "CreateDiskSnapshot",
            "status": "Started",
            "statusChangedAt": 1569625129.739
        },
        {
            "id": "920a25df-185c-4528-87cd-7b85f5488c06",
            "resourceName": "Disk-1",
            "resourceType": "Disk",
            "createdAt": 1569625129.739,
            "location": {
                "availabilityZone": "us-west-2a",
                "regionName": "us-west-2"
            },
            "isTerminal": false,
            "operationDetails": "DiskSnapshot-1",
            "operationType": "CreateDiskSnapshot",
            "status": "Started",
            "statusChangedAt": 1569625129.739
        }
    ]
}

Пример 2: Создание снимка системного диска экземпляра

Следующий пример create-disk-snapshot создает снимок системного диска указанного экземпляра.

aws lightsail create-disk-snapshot \
    --instance-name WordPress-1 \
    --disk-snapshot-name SystemDiskSnapshot-1

Вывод:

{
    "operations": [
        {
            "id": "f508cf1c-6597-42a6-a4c3-4aebd75af0d9",
            "resourceName": "SystemDiskSnapshot-1",
            "resourceType": "DiskSnapshot",
            "createdAt": 1569625294.685,
            "location": {
                "availabilityZone": "all",
                "regionName": "us-west-2"
            },
            "isTerminal": false,
            "operationDetails": "WordPress-1",
            "operationType": "CreateDiskSnapshot",
            "status": "Started",
            "statusChangedAt": 1569625294.685
        },
        {
            "id": "0bb9f712-da3b-4d99-b508-3bf871d989e5",
            "resourceName": "WordPress-1",
            "resourceType": "Instance",
            "createdAt": 1569625294.685,
            "location": {
                "availabilityZone": "us-west-2a",
                "regionName": "us-west-2"
            },
            "isTerminal": false,
            "operationDetails": "SystemDiskSnapshot-1",
            "operationType": "CreateDiskSnapshot",
            "status": "Started",
            "statusChangedAt": 1569625294.685
        }
    ]
}

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

Вывод

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