Spec-Zone.ru › AWS CLI v2

[ aws . ecs ]

update-cluster

Описание

Обновляет кластер.

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

Синтаксис

  update-cluster
--cluster <value>
[--settings <value>]
[--configuration <value>]
[--service-connect-defaults <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]

Параметры

--cluster (строка)

Имя кластера, для которого необходимо изменить параметры.

--settings (список)

Параметры кластера.

(структура)

Параметры, используемые при создании кластера. Этот параметр используется для включения CloudWatch Container Insights с расширенной наблюдаемостью или CloudWatch Container Insights для кластера.

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

Для получения дополнительной информации см. Мониторинг контейнеров Amazon ECS с помощью Container Insights с расширенной наблюдаемостью в Руководстве разработчика Amazon Elastic Container Service.

name -> (строка)

Имя параметра кластера. Значение - containerInsights.

value -> (строка)

Значение параметра кластера. Поддерживаемые значения - enhanced, enabled и disabled.

Для использования Container Insights с расширенной наблюдаемостью, установите параметр учетной записи containerInsights в значение enhanced.

Для использования Container Insights, установите параметр учетной записи containerInsights в значение enabled.

Если значение параметра кластера указано, оно переопределит значение containerInsights, установленное с помощью PutAccountSetting или PutAccountSettingDefault.

Краткая запись:

name=string,value=string ...

Синтаксис JSON:

[
  {
    "name": "containerInsights",
    "value": "string"
  }
  ...
]

--configuration (структура)

Конфигурация команды выполнения для кластера.

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

Детали конфигурации команды выполнения.

kmsKeyId -> (строка)

Укажите идентификатор ключа управления ключами (KMS), чтобы зашифровать данные между локальным клиентом и контейнером.

logging -> (строка)

Параметр ведения журнала для перенаправления логов результатов выполнения команды. Доступны следующие параметры ведения журнала:

  • NONE : Сессия выполнения команды не регистрируется.
  • DEFAULT : Используется конфигурация awslogs в определении задачи. Если параметр логирования не указан, используется по умолчанию. Если в определении задачи не настроена система ведения журналов awslogs, вывод не будет записан.
  • OVERRIDE : Укажите детали ведения журнала в качестве части logConfiguration. Если указан параметр OVERRIDE ведения журнала, необходим параметр logConfiguration.

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

Конфигурация ведения журнала результатов действий команды выполнения. Логи могут быть отправлены в CloudWatch Logs или в хранилище Amazon S3. Когда указан logging=OVERRIDE, необходимо предоставить logConfiguration.

cloudWatchLogGroupName -> (строка)

Имя группы журналов CloudWatch для отправки логов.

Примечание

Группа журналов CloudWatch должна быть уже создана.

cloudWatchEncryptionEnabled -> (булево)

Определяет, использовать ли шифрование для журналов CloudWatch. Если не указано, шифрование отключено.

s3BucketName -> (строка)

Имя хранилища S3 для отправки логов.

Примечание

Хранилище S3 должно быть уже создано.

s3EncryptionEnabled -> (булево)

Определяет, использовать ли шифрование для логов S3. Если не указано, шифрование не используется.

s3KeyPrefix -> (строка)

Необязательная папка в хранилище S3 для размещения логов.

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

Детали конфигурации управляемого хранилища.

kmsKeyId -> (строка)

Укажите идентификатор ключа управления ключами (KMS) для шифрования управляемого хранилища Amazon ECS.

При указании kmsKeyId, Amazon ECS использует ключ для шифрования томов данных, управляемых Amazon ECS, которые подключены к задачам в кластере. Следующие тома данных управляются Amazon ECS: Amazon EBS. Подробнее о шифровании томов Amazon EBS, подключенных к задачам Amazon ECS, см. в Руководстве разработчика Amazon Elastic Container Service.

Ключ должен быть ключом одной зоны.

fargateEphemeralStorageKmsKeyId -> (строка)

Укажите идентификатор ключа управления ключами (KMS) для временного хранилища Fargate.

При указании fargateEphemeralStorageKmsKeyId, Amazon Web Services Fargate использует ключ для шифрования данных в хранилище во время работы. Для получения дополнительной информации об шифровании временного хранилища Fargate, см. Клиентские управляемые ключи для временного хранилища Amazon Web Services Fargate в Amazon ECS в Руководстве разработчика Amazon Elastic Container Service.

Ключ должен быть ключом одной зоны.

Краткая запись:

executeCommandConfiguration={kmsKeyId=string,logging=string,logConfiguration={cloudWatchLogGroupName=string,cloudWatchEncryptionEnabled=boolean,s3BucketName=string,s3EncryptionEnabled=boolean,s3KeyPrefix=string}},managedStorageConfiguration={kmsKeyId=string,fargateEphemeralStorageKmsKeyId=string}

Синтаксис JSON:

{
  "executeCommandConfiguration": {
    "kmsKeyId": "string",
    "logging": "NONE"|"DEFAULT"|"OVERRIDE",
    "logConfiguration": {
      "cloudWatchLogGroupName": "string",
      "cloudWatchEncryptionEnabled": true|false,
      "s3BucketName": "string",
      "s3EncryptionEnabled": true|false,
      "s3KeyPrefix": "string"
    }
  },
  "managedStorageConfiguration": {
    "kmsKeyId": "string",
    "fargateEphemeralStorageKmsKeyId": "string"
  }
}

--service-connect-defaults (структура)

Используйте этот параметр для установки по умолчанию пространства имен Service Connect. После установки пространства имен по умолчанию Service Connect, все новые службы с включенным Service Connect, созданные в кластере, добавляются как клиентские службы в пространстве имен. Этот параметр применяется только к новым службам, которые устанавливают параметр enabled в значение true в ServiceConnectConfiguration. Вы можете установить пространство имен каждой службы индивидуально в ServiceConnectConfiguration, чтобы переопределить этот параметр по умолчанию.

Задачи, выполняющиеся в пространстве имен, могут использовать короткие имена для подключения к службам в этом пространстве имен. Задачи могут подключаться к службам во всех кластерах в пространстве имен. Подключение осуществляется через управляемый контейнер-прокси, который собирает логи и метрики для улучшения видимости. Поддерживаются только задачи, созданные службами Amazon ECS. Дополнительную информацию см. в разделе Service Connect в Руководстве разработчика Amazon Elastic Container Service.

namespace -> (строка)

Имя пространства имен или полный Amazon Resource Name (ARN) пространства имен Cloud Map, используемого при создании службы без указания конфигурации Service Connect. Имя пространства имен может содержать до 1024 символов. Регистр имеет значение. Имя не может содержать символы больше (>), меньше (<), двойные кавычки (“) или слеш (/).

Если вы введете существующее имя пространства имен или ARN, будет использоваться это пространство имен. Поддерживаются все типы пространств имен. Пространство имен должно находиться в этой учетной записи и в этой зоне Amazon Web Services.

Если вы введете новое имя, будет создано пространство имен Cloud Map. Amazon ECS создает пространство имен Cloud Map только с помощью метода обнаружения экземпляров «API-запросы». Этот метод обнаружения экземпляров — это тип пространства имен «HTTP» в командной строке. Другие типы обнаружения экземпляров не используются Service Connect.

Если вы обновите кластер со значением пустой строки "" для имени пространства имен, конфигурация Service Connect для кластера удалится. Обратите внимание, что пространство имен останется в Cloud Map и должно быть удалено отдельно.

Для получения дополнительной информации о Cloud Map, см. работу со службами в Руководстве разработчика Cloud Map.

Краткая запись:

namespace=string

Синтаксис JSON:

{
  "namespace": "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 (boolean)

Включить отладовую запись журнала.

--endpoint-url (string)

Переопределить значение URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

Стиль форматирования для вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки из конфигурации/среды.

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, а двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, сопоставленного с двоичным блоком fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла непосредственно независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного параметра cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Пример 1: Обновление кластера ECS, включение containerInsights

Следующий update-cluster обновляет значение containerInsights до enabled в уже созданном кластере. По умолчанию оно отключено.

aws ecs update-cluster \
    --cluster ECS-project-update-cluster \
    --settings name=containerInsights,value=enabled

Вывод:

"cluster": {
    "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster",
    "clusterName": "ECS-project-update-cluster",
    "status": "ACTIVE",
    "registeredContainerInstancesCount": 0,
    "runningTasksCount": 0,
    "pendingTasksCount": 0,
    "activeServicesCount": 0,
    "statistics": [],
    "tags": [],
    "settings": [
        {
            "name": "containerInsights",
            "value": "enabled"
        }
    ],
    "capacityProviders": [
        "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
    ],
    "defaultCapacityProviderStrategy": [
        {
            "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
            "weight": 1,
            "base": 0
        }
    ],
    "attachments": [
        {
            "id": "069d002b-7634-42e4-b1d4-544f4c8f6380",
            "type": "as_policy",
            "status": "CREATED",
            "details": [
                {
                    "name": "capacityProviderName",
                    "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
                },
                {
                    "name": "scalingPolicyName",
                    "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93"
                }
            ]
        },
        {
            "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a",
            "type": "managed_draining",
            "status": "CREATED",
            "details": [
                {
                    "name": "capacityProviderName",
                    "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
                },
                {
                    "name": "autoScalingLifecycleHookName",
                    "value": "ecs-managed-draining-termination-hook"
                }
            ]
        },
        {
            "id": "45d0b36f-8cff-46b6-9380-1288744802ab",
            "type": "sc",
            "status": "ATTACHED",
            "details": []
        }
    ],
    "attachmentsStatus": "UPDATE_COMPLETE",
    "serviceConnectDefaults": {
        "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-igwrsylmy3kwvcdx"
    }
}

Пример 2: Обновление кластера ECS для установки пространства имен по умолчанию Service Connect

Следующий update-cluster обновляет кластер ECS, устанавливая пространство имен по умолчанию Service Connect.

aws ecs update-cluster \
    --cluster ECS-project-update-cluster \
    --service-connect-defaults namespace=test

Вывод:

 {
     "cluster": {
         "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster",
         "clusterName": "ECS-project-update-cluster",
         "status": "ACTIVE",
         "registeredContainerInstancesCount": 0,
         "runningTasksCount": 0,
         "pendingTasksCount": 0,
         "activeServicesCount": 0,
         "statistics": [],
         "tags": [],
         "settings": [
             {
                 "name": "containerInsights",
                 "value": "enabled"
             }
         ],
         "capacityProviders": [
             "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
         ],
         "defaultCapacityProviderStrategy": [
             {
                 "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt",
                 "weight": 1,
                 "base": 0
             }
         ],
         "attachments": [
             {
                 "id": "069d002b-7634-42e4-b1d4-544f4c8f6380",
                 "type": "as_policy",
                 "status": "CREATED",
                 "details": [
                     {
                         "name": "capacityProviderName",
                         "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
                     },
                     {
                         "name": "scalingPolicyName",
                         "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93"
                     }
                 ]
             },
             {
                 "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a",
                 "type": "managed_draining",
                 "status": "CREATED",
                 "details": [
                     {
                         "name": "capacityProviderName",
                         "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt"
                     },
                     {
                         "name": "autoScalingLifecycleHookName",
                         "value": "ecs-managed-draining-termination-hook"
                     }
                 ]
             },
             {
                 "id": "45d0b36f-8cff-46b6-9380-1288744802ab",
                 "type": "sc",
                 "status": "DELETED",
                 "details": []
             },
             {
                 "id": "3e6890c3-609c-4832-91de-d6ca891b3ef1",
                 "type": "sc",
                 "status": "ATTACHED",
                 "details": []
             },
             {
                 "id": "961b8ec1-c2f1-4070-8495-e669b7668e90",
                 "type": "sc",
                 "status": "DELETED",
                 "details": []
             }
         ],
         "attachmentsStatus": "UPDATE_COMPLETE",
         "serviceConnectDefaults": {
             "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-dtjmxqpfi46ht7dr"
         }
     }
}

Дополнительную информацию о Service Connect см. в разделе Использование Service Connect для подключения служб Amazon ECS с короткими именами в Руководстве разработчика Amazon ECS.

Вывод

кластер -> (структура)

Подробная информация о кластере.

clusterArn -> (строка)

Amazon Resource Name (ARN), идентифицирующий кластер. Дополнительную информацию о формате ARN см. в разделе Amazon Resource Name (ARN) в руководстве разработчика Amazon ECS.

clusterName -> (строка)

Строка, сгенерированная пользователем, используемая для идентификации кластера.

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

Конфигурация команды выполнения и управляемого хранилища для кластера.

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

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

kmsKeyId -> (строка)

Укажите идентификатор ключа Key Management Service для шифрования данных между локальным клиентом и контейнером.

logging -> (строка)

Настройка ведения журнала для перенаправления логов результатов команды выполнения. Доступны следующие настройки ведения журнала.

  • NONE : Сессия выполнения команды не регистрируется.
  • DEFAULT : Используется настройка awslogs в определении задачи. Если параметр ведения журнала не указан, используется это значение по умолчанию. Если в определении задачи не настроена служба ведения журнала awslogs, вывод не будет записан в лог.
  • OVERRIDE : Укажите детали ведения журнала в рамках logConfiguration. Если указан параметр ведения журнала OVERRIDE, необходим параметр logConfiguration.

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

Настройка ведения журнала результатов действий команды выполнения. Логи могут быть отправлены в CloudWatch Logs или в Amazon S3-ведро. При указании параметра logging=OVERRIDE должен быть предоставлен параметр logConfiguration.

cloudWatchLogGroupName -> (строка)

Имя группы журналов CloudWatch для отправки логов.

Примечание

Группа журналов CloudWatch должна быть уже создана.

cloudWatchEncryptionEnabled -> (булево)

Определяет, использовать ли шифрование в CloudWatch Logs. Если не указано, шифрование выключено.

s3BucketName -> (строка)

Имя S3-ведра для отправки логов.

Примечание

S3-ведро должно быть уже создано.

s3EncryptionEnabled -> (булево)

Определяет, использовать ли шифрование в логах S3. Если не указано, шифрование не используется.

s3KeyPrefix -> (строка)

Необязательная папка в S3-ведре для размещения логов.

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

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

kmsKeyId -> (строка)

Укажите идентификатор ключа Key Management Service для шифрования управляемого хранилища Amazon ECS.

При указании идентификатора ключа, Amazon ECS использует его для шифрования томов управляемого хранилища Amazon ECS, подключенных к задачам в кластере. К таким томам относятся Amazon EBS. Дополнительную информацию о шифровании томов Amazon EBS, подключенных к задачам Amazon ECS, см. в руководстве разработчика Amazon Elastic Container Service.

Ключ должен быть ключом одной зоны.

fargateEphemeralStorageKmsKeyId -> (строка)

Укажите идентификатор ключа Key Management Service для временного хранилища Fargate.

При указании идентификатора ключа, Amazon Web Services Fargate использует его для шифрования данных в постоянном хранилище. Дополнительную информацию о шифровании временного хранилища Fargate см. в руководстве разработчика Amazon Elastic Container Service.

Ключ должен быть ключом одной зоны.

status -> (строка)

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

ACTIVE

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

PROVISIONING

У кластера есть поставщики ресурсов, и создаются необходимые ресурсы.

DEPROVISIONING

У кластера есть поставщики ресурсов, и ресурсы для поставщика ресурсов удаляются.

FAILED

У кластера есть поставщики ресурсов, и ресурсы для поставщика ресурсов не удалось создать.

INACTIVE

Кластер был удалён. Кластеры со статусом INACTIVE могут некоторое время оставаться доступными в вашей учётной записи. Однако это поведение может измениться в будущем. Не рекомендуется полагаться на сохранение кластеров со статусом INACTIVE.

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

Количество контейнерных экземпляров, зарегистрированных в кластере. Включает экземпляры в статусах ACTIVE и DRAINING.

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

Количество задач в кластере в состоянии RUNNING.

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

Количество задач в кластере в состоянии PENDING.

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

Количество работающих служб в кластере в состоянии ACTIVE. Эти службы можно просмотреть с помощью PListServices.

statistics -> (список)

Дополнительная информация о кластерах, разделенных по типу запуска. Включает:

  • runningEC2TasksCount
  • RunningFargateTasksCount
  • pendingEC2TasksCount
  • pendingFargateTasksCount
  • activeEC2ServiceCount
  • activeFargateServiceCount
  • drainingEC2ServiceCount
  • drainingFargateServiceCount

(структура)

Объект пар ключ-значение.

name -> (строка)

Имя пары ключ-значение. Для переменных окружения - имя переменной окружения.

value -> (строка)

Значение пары ключ-значение. Для переменных окружения - значение переменной окружения.

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

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

settings -> (список)

Настройки кластера. Этот параметр указывает, включён или выключен CloudWatch Container Insights для кластера.

(структура)

Настройки для создания кластера. Этот параметр используется для включения CloudWatch Container Insights с расширенной наблюдаемостью или CloudWatch Container Insights для кластера.

CloudWatch Container Insights с расширенной наблюдаемостью предоставляет все метрики Container Insights, а также дополнительные метрики задач и контейнеров. Этот вариант поддерживает расширенную наблюдаемость для кластеров Amazon ECS, использующих типы запуска Amazon EC2 и Fargate. После настройки Container Insights с расширенной наблюдаемостью в Amazon ECS, Container Insights автоматически собирает подробную телеметрию инфраструктуры от уровня кластера до уровня контейнера в вашей среде и отображает эти критически важные данные производительности в настраиваемых панелях, упрощая процесс настройки наблюдаемости.

Дополнительную информацию см. в руководстве разработчика Amazon Elastic Container Service.

name -> (строка)

Имя настройки кластера. Значение - containerInsights.

value -> (строка)

Значение для настройки кластера. Поддерживаемые значения - enhanced, enabled и disabled.

Для использования Container Insights с расширенной наблюдаемостью установите настройку учётной записи containerInsights в значение enhanced.

Для использования Container Insights установите настройку учётной записи containerInsights в значение enabled.

Если значение для кластера указано, оно переопределит значение containerInsights, заданное с помощью PutAccountSetting или PutAccountSettingDefault.

capacityProviders -> (список)

Поставщики ресурсов, связанные с кластером.

(строка)

defaultCapacityProviderStrategy -> (список)

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

(структура)

Подробности стратегии поставщика емкости. Стратегию поставщика емкости можно задать при использовании API RunTask или CreateCluster или в качестве стратегии поставщика емкости по умолчанию для кластера с помощью API CreateCluster.

В стратегии поставщика емкости можно использовать только тех поставщиков емкости, которые уже связаны с кластером и имеют статус ACTIVE или UPDATING. API PutClusterCapacityProviders используется для связывания поставщика емкости с кластером.

Если вы указываете поставщика емкости, использующего группу Auto Scaling, поставщик емкости должен быть уже создан. Новые поставщики емкости на основе групп Auto Scaling можно создать с помощью операции API CreateClusterCapacityProvider.

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

С помощью FARGATE_SPOT вы можете запускать задачи, устойчивые к прерываниям, со скидкой по сравнению с ценой FARGATE. FARGATE_SPOT запускает задачи на свободных вычислительных ресурсах. Когда Amazon Web Services нуждается в этих ресурсах обратно, ваши задачи прерываются с двухминутным предупреждением. FARGATE_SPOT поддерживает задачи Linux с архитектурой X86_64 на платформе версии 1.3.0 или выше. FARGATE_SPOT поддерживает задачи Linux с архитектурой ARM64 на платформе версии 1.4.0 или выше.

Стратегия поставщика емкости может содержать не более 20 поставщиков емкости.

capacityProvider -> (строка)

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

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

Значение weight определяет относительный процент общего числа запускаемых задач, которые должны использовать указанного поставщика емкости. Значение weight учитывается после удовлетворения значения base, если оно определено.

Если значение weight не указано, используется значение по умолчанию 0. Если в стратегии поставщика емкости указано несколько поставщиков емкости, по крайней мере один из поставщиков емкости должен иметь значение weight, большее нуля, а любые поставщики емкости с весом 0 не могут использоваться для размещения задач. Если вы указываете несколько поставщиков емкости в стратегии, у которых все имеют значение weight 0, любые действия RunTask или CreateService, использующие стратегию поставщика емкости, завершатся ошибкой.

Пример использования весов: определение стратегии, содержащей двух поставщиков емкости, у которых оба имеют вес 1, а затем, когда удовлетворяется base, задачи будут распределены равномерно между двумя поставщиками емкости. Используя ту же логику, если вы указываете вес 1 для capacityProviderA и вес 4 для capacityProviderB, то на каждую задачу, запущенную с помощью capacityProviderA, четыре задачи будут использовать capacityProviderB.

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

Значение base определяет минимальное количество задач, которые необходимо запустить на указанном поставщике емкости. Только один поставщик емкости в стратегии поставщика емкости может иметь заданное значение base. Если значение не указано, используется значение по умолчанию 0.

attachments -> (список)

Ресурсы, прикрепленные к кластеру. При использовании поставщика емкости с кластером поставщик емкости и связанные ресурсы возвращаются в качестве прикреплений к кластеру.

(структура)

Объект, представляющий прикрепление экземпляра контейнера или задачи.

id -> (строка)

Уникальный идентификатор прикрепления.

type -> (строка)

Тип прикрепления, например, ElasticNetworkInterface, Service Connect и AmazonElasticBlockStorage.

status -> (строка)

Статус прикрепления. Допустимые значения: PRECREATED, CREATED, ATTACHING, ATTACHED, DETACHING, DETACHED, DELETED и FAILED.

details -> (список)

Подробности прикрепления.

Для сетевых интерфейсов это включает идентификатор сетевого интерфейса, MAC-адрес, идентификатор подсети и частный IPv4-адрес.

Для сервисов Service Connect это включает portName, clientAliases, discoveryName и ingressPortOverride.

Для Elastic Block Storage это включает roleArn, deleteOnTermination, volumeName, volumeId и statusReason (только когда прикрепление не может быть создано или прикреплено).

(структура)

Объект пары «ключ-значение».

name -> (строка)

Имя пары «ключ-значение». Для переменных среды это имя переменной среды.

value -> (строка)

Значение пары «ключ-значение». Для переменных среды это значение переменной среды.

attachmentsStatus -> (строка)

Статус поставщиков емкости, связанных с кластером. Ниже приведены возвращаемые состояния.

UPDATE_IN_PROGRESS

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

UPDATE_COMPLETE

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

UPDATE_FAILED

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

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

Используйте этот параметр для задания пространства имен по умолчанию Service Connect. После задания пространства имен по умолчанию Service Connect любые новые сервисы с включенным Service Connect, созданные в кластере, добавляются в качестве клиентских сервисов в этом пространстве имен. Это значение применяется только к новым сервисам, которые устанавливают параметр enabled в значение true в ServiceConnectConfiguration. Вы можете задать пространство имен каждого сервиса индивидуально в ServiceConnectConfiguration, чтобы переопределить этот параметр по умолчанию.

Задачи, запущенные в пространстве имен, могут использовать короткие имена для подключения к сервисам в пространстве имен. Задачи могут подключаться к сервисам во всех кластерах в пространстве имен. Задачи подключаются через управляемый контейнер прокси, который собирает журналы и метрики для повышения видимости. Поддерживаются только задачи, созданные сервисами Amazon ECS. Дополнительную информацию см. в разделе Service Connect в Руководстве разработчика Amazon Elastic Container Service.

namespace -> (строка)

Имя пространства имен или полное имя ресурса (ARN) пространства имен Cloud Map. При создании сервиса без указания конфигурации Service Connect используется это пространство имен.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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