Spec-Zone.ru › AWS CLI v2

[ aws . ecs ]

удалить-провайдера-ёмкости

Описание

Удаляет указанного поставщика ёмкости.

Примечание

Поставщики ёмкости FARGATE и FARGATE_SPOT зарезервированы и не могут быть удалены. Их можно отключить от кластера, используя PutClusterCapacityProviders или удалив кластер.

Перед удалением поставщика ёмкости его необходимо удалить из стратегии поставщиков ёмкости всех сервисов. API UpdateService можно использовать для удаления поставщика ёмкости из стратегии поставщиков ёмкости сервиса. При обновлении сервиса можно использовать параметр forceNewDeployment, чтобы гарантировать, что все задачи, использующие ёмкость экземпляров Amazon EC2, предоставленную поставщиком ёмкости, будут переведены на использование ёмкости от оставшихся поставщиков ёмкости. Удалить можно только поставщиков ёмкости, которые не связаны с кластером. Чтобы удалить поставщика ёмкости из кластера, можно использовать PutClusterCapacityProviders или удалить кластер.

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

Синтаксис

  delete-capacity-provider
--capacity-provider <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]

Параметры

--capacity-provider (строка)

Короткое имя или полное Amazon Resource Name (ARN) поставщика ёмкости, который нужно удалить.

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

Примеры

Примечание

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

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

Пример 1: Удаление поставщика ёмкости, используя Amazon Resource Name (ARN)

Следующий delete-capacity-provider пример удаляет поставщика ёмкости, указав Amazon Resource Name (ARN) поставщика ёмкости. ARN, а также статус удаления поставщика ёмкости можно получить, используя команду describe-capacity-providers.

aws ecs delete-capacity-provider \
    --capacity-provider arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider

Вывод:

{
    "capacityProvider": {
        "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider",
        "name": "ExampleCapacityProvider",
        "status": "ACTIVE",
        "autoScalingGroupProvider": {
            "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
            "managedScaling": {
                "status": "ENABLED",
                "targetCapacity": 100,
                "minimumScalingStepSize": 1,
                "maximumScalingStepSize": 10000
            },
            "managedTerminationProtection": "DISABLED"
        },
        "updateStatus": "DELETE_IN_PROGRESS",
        "tags": []
    }
}

Для получения дополнительной информации см. Поставщики ёмкости кластера в Руководстве разработчика Amazon ECS.

Пример 2: Удаление поставщика ёмкости, используя имя

Следующий delete-capacity-provider пример удаляет поставщика ёмкости, указав короткое имя поставщика ёмкости. Короткое имя, а также статус удаления поставщика ёмкости можно получить, используя команду describe-capacity-providers.

aws ecs delete-capacity-provider \
    --capacity-provider ExampleCapacityProvider

Вывод:

{
    "capacityProvider": {
        "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider",
        "name": "ExampleCapacityProvider",
        "status": "ACTIVE",
        "autoScalingGroupProvider": {
            "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup",
            "managedScaling": {
                "status": "ENABLED",
                "targetCapacity": 100,
                "minimumScalingStepSize": 1,
                "maximumScalingStepSize": 10000
            },
            "managedTerminationProtection": "DISABLED"
        },
        "updateStatus": "DELETE_IN_PROGRESS",
        "tags": []
    }
}

Для получения дополнительной информации см. Поставщики ёмкости кластера в Руководстве разработчика Amazon ECS.

Вывод

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

Подробная информация о поставщике ресурсов.

capacityProviderArn -> (строка)

Идентификатор поставщика ресурсов в формате Amazon Resource Name (ARN).

name -> (строка)

Имя поставщика ресурсов.

status -> (строка)

Текущий статус поставщика ресурсов. Только поставщики ресурсов в состоянии ACTIVE могут использоваться в кластере. После успешного удаления поставщика ресурсов его статус меняется на INACTIVE.

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

Настройки группы Auto Scaling для поставщика ресурсов.

autoScalingGroupArn -> (строка)

Идентификатор группы Auto Scaling в формате Amazon Resource Name (ARN) или имя группы Auto Scaling.

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

Настройки управляемого масштабирования для поставщика ресурсов группы Auto Scaling.

status -> (строка)

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

targetCapacity -> (целое число)

Целевая загрузка производительности (в процентах) для поставщика ресурсов. Указанное значение должно быть больше 0 и меньше или равно 100. Например, если вы хотите, чтобы поставщик ресурсов поддерживал 10% резервного ресурса, то это означает, что загрузка составляет 90%, поэтому используйте значение targetCapacity равное 90. По умолчанию значение 100 процентов обеспечивает полное использование экземпляров Amazon EC2 в вашей группе Auto Scaling.

minimumScalingStepSize -> (целое число)

Минимальное количество экземпляров Amazon EC2, которое Amazon ECS будет увеличивать за один раз. Процесс уменьшения количества экземпляров не затрагивается этим параметром. Если параметр опущен, используется значение по умолчанию 1.

При необходимости дополнительной емкости Amazon ECS будет увеличивать минимальный шаг масштабирования, даже если фактическая потребность меньше минимального значения шага масштабирования.

Если вы используете поставщик ресурсов с группой Auto Scaling, настроенной для нескольких типов экземпляров Amazon EC2 или зон доступности, Amazon ECS будет масштабироваться на точно минимальный шаг масштабирования и проигнорирует как максимальный шаг масштабирования, так и потребность в емкости.

maximumScalingStepSize -> (целое число)

Максимальное количество экземпляров Amazon EC2, которое Amazon ECS будет увеличивать за один раз. Если параметр опущен, используется значение по умолчанию 10000.

instanceWarmupPeriod -> (целое число)

Период времени (в секундах) после запуска нового экземпляра Amazon EC2, когда он может вносить свой вклад в метрики CloudWatch для группы Auto Scaling. Если параметр опущен, используется значение по умолчанию 300 секунд.

managedTerminationProtection -> (строка)

Настройка управляемой защиты от завершения работы для поставщика ресурсов группы Auto Scaling. Это определяет, включена ли управляемая защита от завершения работы для группы Auto Scaling. По умолчанию она выключена.

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

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

Когда управляемая защита от завершения работы включена, Amazon ECS предотвращает завершение работы экземпляров Amazon EC2 в группе Auto Scaling, содержащих задачи, во время действия масштабирования в меньшую сторону. Группа Auto Scaling и каждый экземпляр в группе Auto Scaling должны также иметь защиту от действий масштабирования в меньшую сторону. Подробную информацию см. в разделе Защита экземпляров в руководстве пользователя Auto Scaling.

Когда управляемая защита от завершения работы выключена, ваши экземпляры Amazon EC2 не защищены от завершения работы при масштабировании группы Auto Scaling в меньшую сторону.

managedDraining -> (строка)

Вариант управляемого отключения для поставщика ресурсов группы Auto Scaling. При включении Amazon ECS управляет и плавно выключает контейнерные экземпляры EC2, которые находятся в поставщике ресурсов группы Auto Scaling.

updateStatus -> (строка)

Статус обновления поставщика ресурсов. Возможные состояния:

DELETE_IN_PROGRESS

Поставщик ресурсов находится в процессе удаления.

DELETE_COMPLETE

Поставщик ресурсов был успешно удален и имеет состояние INACTIVE.

DELETE_FAILED

Поставщик ресурсов не может быть удален. Причина состояния обновления предоставляет дополнительные сведения о причинах неудачи удаления.

updateStatusReason -> (строка)

Причина состояния обновления. Она предоставляет дополнительные сведения о состоянии обновления для поставщика ресурсов.

tags -> (список)

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

Применяются следующие базовые ограничения к тегам:

  • Максимальное количество тегов на ресурс - 50
  • Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
  • Максимальная длина ключа - 128 символов Юникода в UTF-8
  • Максимальная длина значения - 256 символов Юникода в UTF-8
  • Если ваша схема тегов используется в нескольких сервисах и ресурсах, помните, что другие сервисы могут иметь ограничения на разрешенные символы. В целом разрешенными символами являются: буквы, цифры и пробелы, представимые в UTF-8, а также следующие символы: + - = . _ : / @.
  • Ключи и значения тегов чувствительны к регистру.
  • Не используйте aws: , AWS: или любые комбинации верхнего или нижнего регистра, такие как префикс для ключей или значений, так как они зарезервированы для использования Amazon Web Services. Вы не можете редактировать или удалять ключи или значения тегов с этим префиксом. Теги с этим префиксом не учитываются при подсчете тегов на ресурс.

(структура)

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

Применяются следующие базовые ограничения к тегам:

  • Максимальное количество тегов на ресурс - 50
  • Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
  • Максимальная длина ключа - 128 символов Юникода в UTF-8
  • Максимальная длина значения - 256 символов Юникода в UTF-8
  • Если ваша схема тегов используется в нескольких сервисах и ресурсах, помните, что другие сервисы могут иметь ограничения на разрешенные символы. В целом разрешенными символами являются: буквы, цифры и пробелы, представимые в UTF-8, а также следующие символы: + - = . _ : / @.
  • Ключи и значения тегов чувствительны к регистру.
  • Не используйте aws: , AWS: или любые комбинации верхнего или нижнего регистра, такие как префикс для ключей или значений, так как они зарезервированы для использования Amazon Web Services. Вы не можете редактировать или удалять ключи или значения тегов с этим префиксом. Теги с этим префиксом не учитываются при подсчете тегов на ресурс.

key -> (строка)

Часть пары ключ-значение, составляющей тег. Ключ - это общее обозначение, которое действует как категория для более конкретных значений тегов.

value -> (строка)

Необязательная часть пары ключ-значение, составляющей тег. Значение действует как описание в категории тега (ключ).

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

Spec-Zone.ru

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