Spec-Zone.ru › AWS CLI v2

[ aws . ecs ]

list-account-settings

Описание

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

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

list-account-settings является постраничной операцией. Для получения всего набора результатов могут быть выпущены несколько API-запросов. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответ на постраничный запрос, аргумент --query должен извлечь данные из результатов следующих выражений запроса: settings

Синтаксис

  list-account-settings
[--name <value>]
[--value <value>]
[--principal-arn <value>]
[--effective-settings | --no-effective-settings]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]

Параметры

--name (строка)

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

Возможные значения:

  • serviceLongArnFormat
  • taskLongArnFormat
  • containerInstanceLongArnFormat
  • awsvpcTrunking
  • containerInsights
  • fargateFIPSMode
  • tagResourceAuthorization
  • fargateTaskRetirementWaitPeriod
  • guardDutyActivate
  • defaultLogDriverMode

--value (строка)

Значение настроек учетной записи для фильтрации результатов. Также необходимо указать имя настройки учетной записи.

--principal-arn (строка)

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

Для использования этого параметра необходимо быть корневым пользователем или принципалом.

Примечание

Федеративные пользователи принимают настройки учетной записи корневого пользователя и не могут иметь явных настроек учетной записи.

--effective-settings | --no-effective-settings (логическое значение)

Определяет, возвращать ли эффективные настройки. Если true , возвращаются настройки учетной записи корневого пользователя или настройки по умолчанию для principalArn. Если false , возвращаются настройки учетной записи для principalArn, если они заданы. В противном случае настройки учетной записи не возвращаются.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, заданному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения перепишут значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

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

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения данных в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выходных данных команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймаут вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов, которые необходимо вернуть в выходных данных команды. Если общее количество доступных элементов превышает указанное значение, в выходных данных команды предоставляется NextToken. Для возобновления постраничной обработки предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Выражение JMESPath для фильтрации данных ответа.

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--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: Просмотр настроек учетной записи для учетной записи

Следующий list-account-settings пример отображает эффективные настройки учетной записи для учетной записи.

aws ecs list-account-settings --effective-settings

Вывод:

{
    "settings": [
        {
            "name": "containerInstanceLongArnFormat",
            "value": "enabled",
            "principalArn": "arn:aws:iam::123456789012:root"
        },
        {
            "name": "serviceLongArnFormat",
            "value": "enabled",
            "principalArn": "arn:aws:iam::123456789012:root"
        },
        {
            "name": "taskLongArnFormat",
            "value": "enabled",
            "principalArn": "arn:aws:iam::123456789012:root"
        }
    ]
}

Пример 2: Просмотр настроек учетной записи для конкретного пользователя IAM или роли IAM

Следующий list-account-settings пример отображает настройки учетной записи для указанного пользователя IAM или роли IAM.

aws ecs list-account-settings --principal-arn arn:aws:iam::123456789012:user/MyUser

Вывод:

{
    "settings": [
        {
            "name": "serviceLongArnFormat",
            "value": "enabled",
            "principalArn": "arn:aws:iam::123456789012:user/MyUser"
        }
    ]
}

Дополнительную информацию см. в разделе Имена ресурсов Amazon (ARN) и идентификаторы в Руководстве разработчика Amazon ECS.

Вывод

settings -> (список)

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

(структура)

Текущая настройка учетной записи для ресурса.

name -> (строка)

Имя ресурса Amazon ECS.

value -> (строка)

Указывает, включена или выключена настройка учетной записи для указанного ресурса.

principalArn -> (строка)

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

type -> (строка)

Указывает, управляет ли Amazon Web Services настройкой учетной записи или управляет ею пользователь.

aws_managed настройки учетной записи являются только для чтения, так как Amazon Web Services управляет ими от имени клиента. В настоящее время guardDutyActivate настройка учетной записи — это единственная управляемая Amazon Web Services.

nextToken -> (строка)

Значение nextToken для включения в последующий запрос ListAccountSettings. Когда результаты запроса ListAccountSettings превышают maxResults , это значение может быть использовано для получения следующей страницы результатов. Это значение null, когда больше результатов для возврата нет.

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

Spec-Zone.ru

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