удалить-провайдера-ёмкости
Описание
Удаляет указанного поставщика ёмкости.
Примечание
Поставщики ёмкости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 (строка)
--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 -> (строка)
name -> (строка)
status -> (строка)
ACTIVE могут использоваться в кластере. После успешного удаления поставщика ресурсов его статус меняется на INACTIVE.autoScalingGroupProvider -> (структура)
Настройки группы Auto Scaling для поставщика ресурсов.
autoScalingGroupArn -> (строка)
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 -> (целое число)
10000.instanceWarmupPeriod -> (целое число)
300 секунд.managedTerminationProtection -> (строка)
Настройка управляемой защиты от завершения работы для поставщика ресурсов группы Auto Scaling. Это определяет, включена ли управляемая защита от завершения работы для группы Auto Scaling. По умолчанию она выключена.
Предупреждение
При использовании управляемой защиты от завершения работы необходимо также использовать управляемое масштабирование, иначе управляемая защита от завершения работы не сработает.Когда управляемая защита от завершения работы включена, Amazon ECS предотвращает завершение работы экземпляров Amazon EC2 в группе Auto Scaling, содержащих задачи, во время действия масштабирования в меньшую сторону. Группа Auto Scaling и каждый экземпляр в группе Auto Scaling должны также иметь защиту от действий масштабирования в меньшую сторону. Подробную информацию см. в разделе Защита экземпляров в руководстве пользователя Auto Scaling.
Когда управляемая защита от завершения работы выключена, ваши экземпляры Amazon EC2 не защищены от завершения работы при масштабировании группы Auto Scaling в меньшую сторону.
managedDraining -> (строка)
updateStatus -> (строка)
Статус обновления поставщика ресурсов. Возможные состояния:
Поставщик ресурсов находится в процессе удаления.
Поставщик ресурсов был успешно удален и имеет состояние INACTIVE.
Поставщик ресурсов не может быть удален. Причина состояния обновления предоставляет дополнительные сведения о причинах неудачи удаления.
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.