Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

удалить-метки

Описание

Удаляет указанный набор меток из указанного набора ресурсов.

Чтобы перечислить текущие метки, используйте DescribeTags . Дополнительную информацию о метках см. в руководстве пользователя Amazon Elastic Compute Cloud Пометьте свои ресурсы Amazon EC2.

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

Синтаксис

  delete-tags
[--dry-run | --no-dry-run]
--resources <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]

Параметры

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

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

--resources (список)

Идентификаторы ресурсов, разделенные пробелами.

Ограничения: до 1000 идентификаторов ресурсов. Рекомендуется разбивать этот запрос на более мелкие пакеты.

(строка)

Синтаксис:

"string" "string" ...

--tags (список)

Метки для удаления. Укажите ключ метки и необязательное значение метки, чтобы удалить определенные метки. Если вы укажете ключ метки без значения метки, мы удалим любую метку с этим ключом независимо от ее значения. Если вы укажете ключ метки с пустой строкой в качестве значения метки, мы удалим метку только в том случае, если ее значение является пустой строкой.

Если вы опустите этот параметр, мы удалим все пользовательские метки для указанных ресурсов. Мы не удаляем метки, сгенерированные Amazon Web Services (метки, имеющие префикс aws:).

Ограничения: до 1000 меток.

(структура)

Описание метки.

Ключ -> (строка)

Ключ метки.

Ограничения: ключи меток чувствительны к регистру и принимают максимум 127 символов Юникода. Не может начинаться с aws: .

Значение -> (строка)

Значение метки.

Ограничения: значения меток чувствительны к регистру и принимают максимум 256 символов Юникода.

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

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 (строка)

Область, которую нужно использовать. Переопределяет настройки config/env.

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • авто

--no-sign-request (логический)

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

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

Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки config/env.

--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.

Примеры

Примечание

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

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

Пример 1: Удаление метки из ресурса

Следующий пример delete-tags удаляет метку Stack=Test из указанного образа. При указании значения и имени ключа метка удаляется только в том случае, если значение метки соответствует указанному значению.

aws ec2 delete-tags \
    --resources ami-1234567890abcdef0 \
    --tags Key=Stack,Value=Test

Указание значения метки необязательно. Следующий пример delete-tags удаляет метку с именем ключа purpose из указанного экземпляра независимо от значения метки.

aws ec2 delete-tags \
    --resources i-1234567890abcdef0 \
    --tags Key=purpose

Если вы укажете пустую строку в качестве значения метки, метка удаляется только в том случае, если ее значение является пустой строкой. Следующий пример delete-tags указывает пустую строку как значение метки для удаления.

aws ec2 delete-tags \
    --resources i-1234567890abcdef0 \
    --tags Key=Name,Value=

Пример 2: Удаление метки из нескольких ресурсов

Следующий пример delete-tags удаляет метку``Purpose=Test`` как из экземпляра, так и из AMI. Как показано в предыдущем примере, вы можете опустить значение метки из команды.

aws ec2 delete-tags \
    --resources i-1234567890abcdef0 ami-1234567890abcdef0 \
    --tags Key=Purpose

Вывод

Нет

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

Spec-Zone.ru

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