[ aws . storagegateway ]
create-snapshot
Описание
Инициализирует создание моментальной копии тома.
Storage Gateway предоставляет возможность создавать моментальные копии данных в определенный момент времени и сохранять их в Amazon Simple Storage (Amazon S3) для надежного восстановления данных в другом месте, а также импортировать данные в том Amazon Elastic Block Store (EBS) в Amazon Elastic Compute Cloud (EC2). Вы можете создавать моментальные копии своего тома по расписанию или по запросу. Данный API позволяет создать моментальную копию по запросу. Для получения дополнительной информации см. Редактирование расписания создания моментальных копий .
В запросе CreateSnapshot вы определяете том по его Amazon Resource Name (ARN). Вы также должны предоставить описание для моментальной копии. Когда Storage Gateway создает моментальную копию указанного тома, моментальная копия и описание отображаются в консоли Storage Gateway. В ответ Storage Gateway возвращает вам идентификатор моментальной копии. Вы можете использовать этот идентификатор для проверки прогресса создания моментальной копии или в дальнейшем для создания тома из моментальной копии. Эта операция поддерживается только для томов типа хранилища и кэширования.
Примечание
Для перечисления или удаления моментальной копии необходимо использовать Amazon EC2 API. Для получения дополнительной информации см. DescribeSnapshots или DeleteSnapshot в справочнике по API Amazon Elastic Compute Cloud .Предупреждение
Идентификаторы томов и моментальных копий изменяются на формат с более длинным идентификатором. Для получения дополнительной информации см. важное примечание на странице «Добро пожаловать».См. также: Документация AWS API
Синтаксис
create-snapshot
--volume-arn <value>
--snapshot-description <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]
Параметры
--volume-arn (строка)
--snapshot-description (строка)
--tags (список)
Список до 50 тегов, которые можно назначить моментальной копии. Каждый тег представляет собой пару ключ-значение.
Примечание
Допустимые символы для ключа и значения — буквы, пробелы и цифры, представляемые в формате UTF-8, а также следующие специальные символы: + - = . _ : / @. Максимальная длина ключа тега — 128 символов, а максимальная длина значения тега — 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
- 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.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
VolumeARN -> (строка)
SnapshotId -> (строка)
DescribeSnapshots ) или создание тома из моментальной копии ( CreateStorediSCSIVolume ).
© Copyright 2025, Amazon Web Services. Created using Sphinx.
|
|