Spec-Zone.ru › AWS CLI v2

[ aws . ssm ]

update-service-setting

Описание

ServiceSetting — это настройка на уровне учетной записи для сервиса Amazon Web Services. Эта настройка определяет, как пользователь взаимодействует с сервисом или функцией сервиса. Например, если сервис Amazon Web Services взимает плату за использование функции или сервиса, то команда разработчиков сервиса Amazon Web Services может установить значение по умолчанию "false". Это означает, что пользователь не может использовать эту функцию, пока не изменит настройку на "true" и не включит платную функцию.

Сервисы сопоставляют объект SettingId со значением настройки. Команды разработчиков сервисов Amazon Web Services определяют значение по умолчанию для SettingId. Вы не можете создать новую SettingId, но можете переопределить значение по умолчанию, если у вас есть разрешение ssm:UpdateServiceSetting на эту настройку. Используйте операцию API GetServiceSetting, чтобы просмотреть текущее значение. Или используйте ResetServiceSetting, чтобы изменить значение обратно на значение по умолчанию, определённое командой разработчиков сервиса Amazon Web Services.

Обновите настройку сервиса для учетной записи.

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

Синтаксис

  update-service-setting
--setting-id <value>
--setting-value <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]

Параметры

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

Amazon Resource Name (ARN) настройки сервиса для обновления. Например, arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled. Идентификатор настройки может быть одним из следующих:

  • /ssm/appmanager/appmanager-enabled
  • /ssm/automation/customer-script-log-destination
  • /ssm/automation/customer-script-log-group-name
  • /ssm/automation/enable-adaptive-concurrency
  • /ssm/documents/console/public-sharing-permission
  • /ssm/managed-instance/activation-tier
  • /ssm/managed-instance/default-ec2-instance-management-role
  • /ssm/opsinsights/opscenter
  • /ssm/parameter-store/default-parameter-tier
  • /ssm/parameter-store/high-throughput-enabled

Примечание

Разрешения на обновление настройки /ssm/managed-instance/default-ec2-instance-management-role должны предоставляться только администраторам. Реализуйте принцип минимальных привилегий при предоставлении пользователям доступа к настройке или изменению Конфигурации Управления Хостом по умолчанию.

--setting-value (строка)

Новое значение для настройки сервиса. Следующий список определяет доступные значения для каждой настройки.

  • Для /ssm/appmanager/appmanager-enabled, введите True или False.
  • Для /ssm/automation/customer-script-log-destination, введите CloudWatch.
  • Для /ssm/automation/customer-script-log-group-name, введите имя группы логов Amazon CloudWatch Logs.
  • Для /ssm/documents/console/public-sharing-permission, введите Enable или Disable.
  • Для /ssm/managed-instance/activation-tier, введите standard или advanced.
  • Для /ssm/managed-instance/default-ec2-instance-management-role, введите имя роли IAM.
  • Для /ssm/opsinsights/opscenter, введите Enabled или Disabled.
  • Для /ssm/parameter-store/default-parameter-tier, введите Standard, Advanced или Intelligent-Tiering.
  • Для /ssm/parameter-store/high-throughput-enabled, введите true или false.

--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 V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку 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.

Чтобы обновить настройки службы для пропускной способности Parameter Store

Следующий update-service-setting пример обновляет текущую настройку службы пропускной способности Parameter Store в указанном регионе для использования повышенной пропускной способности.

aws ssm update-service-setting \
    --setting-id arn:aws:ssm:us-east-1:123456789012:servicesetting/ssm/parameter-store/high-throughput-enabled \
    --setting-value true

Эта команда не генерирует вывод.

Дополнительную информацию см. в разделе Увеличение пропускной способности Parameter Store в руководстве пользователя AWS Systems Manager.

Вывод

Нет

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

Spec-Zone.ru

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