изменение-атрибута-снимка

Описание

Добавляет или удаляет параметры разрешений для указанного снимка. Вы можете добавить или удалить указанные идентификаторы учетных записей Amazon Web Services из списка разрешений на создание томов для снимка, но вы не можете сделать оба действия в одной операции. Если вам нужно добавить и удалить идентификаторы учетных записей для снимка, вы должны использовать несколько операций. Вы можете внести до 500 изменений в снимок в одной операции.

Зашифрованные снимки и снимки с кодами продуктов Amazon Web Services Marketplace не могут быть сделаны общедоступными. Снимки, зашифрованные с помощью вашего ключа KMS по умолчанию, не могут быть предоставлены другим учетным записям.

Дополнительную информацию об изменении разрешений снимка см. в разделе «Разделение снимка» в руководстве пользователя Amazon EBS.

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

Синтаксис

  modify-snapshot-attribute
[--attribute <value>]
[--create-volume-permission <value>]
[--group-names <value>]
[--operation-type <value>]
--snapshot-id <value>
[--user-ids <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]

Параметры

--attribute (строка)

--create-volume-permission (структура)

Сокращенная запись:

Add=[{UserId=string,Group=string},{UserId=string,Group=string}],Remove=[{UserId=string,Group=string},{UserId=string,Group=string}]

Синтаксис JSON:

{
  "Add": [
    {
      "UserId": "string",
      "Group": "all"
    }
    ...
  ],
  "Remove": [
    {
      "UserId": "string",
      "Group": "all"
    }
    ...
  ]
}

--group-names (список)

Синтаксис:

"string" "string" ...

--operation-type (строка)

--snapshot-id (строка)

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

Синтаксис:

"string" "string" ...

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

--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 для вывода.

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

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

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

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

Примеры

Пример 1: Изменение атрибута снимка

Следующий пример обновляет атрибут снимка, удаляя разрешения на доступ к томам для указанного пользователя.

aws ec2 modify-snapshot-attribute \
    --snapshot-id snap-1234567890abcdef0 \
    --attribute createVolumePermission \
    --operation-type remove \
    --user-ids 123456789012

Пример 2: Делаем снимок общедоступным

Следующий пример делает указанный снимок общедоступным.

aws ec2 modify-snapshot-attribute \
    --snapshot-id snap-1234567890abcdef0 \
    --attribute createVolumePermission \
    --operation-type add \
    --group-names all

Вывод

Нет