Spec-Zone.ru › AWS CLI v2

[ aws . service-quotas ]

list-service-quotas

Описание

Отображает применённые значения квот для указанной службы Amazon Web Services. Для некоторых квот доступны только значения по умолчанию. Если применённое значение квоты недоступно для квоты, квота не извлекается. Фильтруйте ответы, чтобы получить применённые значения квот на уровне учётной записи, ресурса или на всех уровнях.

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

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

Синтаксис

  list-service-quotas
--service-code <value>
[--quota-code <value>]
[--quota-applied-at-level <value>]
[--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]

Параметры

--service-code (строка)

Указывает идентификатор службы. Чтобы найти код службы для службы Amazon Web Services, используйте операцию ListServices.

--quota-code (строка)

Указывает идентификатор квоты. Чтобы найти код квоты для конкретной квоты, используйте операцию ListServiceQuotas и найдите соответствующий QuotaCode ответ в выводе для нужной квоты.

--quota-applied-at-level (строка)

Фильтрует ответ, чтобы вернуть применённые значения квот для уровней ACCOUNT, RESOURCE или ALL. ACCOUNT — значение по умолчанию.

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

  • ACCOUNT
  • RESOURCE
  • ALL

--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-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Примечание

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

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

Для отображения квот для службы

Следующий пример list-service-quotas отображает подробности о квотах для AWS CloudFormation.

aws service-quotas list-service-quotas \
    --service-code cloudformation

Вывод:

{
    "Quotas": [
        {
            "ServiceCode": "cloudformation",
            "ServiceName": "AWS CloudFormation",
            "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:cloudformation/L-87D14FB7",
            "QuotaCode": "L-87D14FB7",
            "QuotaName": "Output count in CloudFormation template",
            "Value": 60.0,
            "Unit": "None",
            "Adjustable": false,
            "GlobalQuota": false
        },
        {
            "ServiceCode": "cloudformation",
            "ServiceName": "AWS CloudFormation",
            "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:cloudformation/L-0485CB21",
            "QuotaCode": "L-0485CB21",
            "QuotaName": "Stack count",
            "Value": 200.0,
            "Unit": "None",
            "Adjustable": true,
            "GlobalQuota": false
        }
    ]
}

Вывод

NextToken -> (строка)

Если присутствует, указывает на то, что доступно больше вывода, чем включено в текущий ответ. Используйте это значение в параметре запроса NextToken в последующем вызове операции для получения следующей части вывода. Вы должны повторять это, пока элемент ответа NextToken не вернется как null .

Квоты -> (список)

Информация о квотах.

(структура)

Информация о квоте.

ServiceCode -> (строка)

Указывает идентификатор службы. Чтобы найти значение кода службы для службы Amazon Web Services, используйте операцию ListServices.

ServiceName -> (строка)

Указывает имя службы.

QuotaArn -> (строка)

Идентификатор ресурса Amazon (ARN) квоты.

QuotaCode -> (строка)

Указывает идентификатор квоты. Чтобы найти код квоты для определенной квоты, используйте операцию ListServiceQuotas и найдите значение QuotaCode в выводе для нужной квоты.

QuotaName -> (строка)

Указывает имя квоты.

Value -> (двойное)

Значение квоты.

Unit -> (строка)

Единица измерения.

Adjustable -> (булево)

Указывает, можно ли увеличить значение квоты.

GlobalQuota -> (булево)

Указывает, является ли квота глобальной.

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

Информация о показателе.

MetricNamespace -> (строка)

Пространство имен метрики.

MetricName -> (строка)

Имя метрики.

MetricDimensions -> (отображение)

Измерение метрики. Это пара имя/значение, которая является частью идентификатора метрики.

key -> (строка)

value -> (строка)

MetricStatisticRecommendation -> (строка)

Рекомендуемая нами метрика статистики для определения использования квоты.

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

Период времени.

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

Значение, связанное с отчётным PeriodUnit .

PeriodUnit -> (строка)

Единица времени.

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

Код ошибки и причина ошибки.

ErrorCode -> (строка)

Service Quotas возвращает следующие значения ошибок:

  • DEPENDENCY_ACCESS_DENIED_ERROR - У вызывающего лица недостаточно необходимых разрешений для выполнения действия. Для решения проблемы необходимо иметь разрешения на доступ к службе Amazon Web Services или квоте.
  • DEPENDENCY_THROTTLING_ERROR - Служба Amazon Web Services ограничила Service Quotas.
  • DEPENDENCY_SERVICE_ERROR - Служба Amazon Web Services недоступна.
  • SERVICE_QUOTA_NOT_AVAILABLE_ERROR - Возникла ошибка в Service Quotas.

ErrorMessage -> (строка)

Сообщение об ошибке.

QuotaAppliedAtLevel -> (строка)

Фильтрует ответ, чтобы вернуть примененные значения квот для уровней ACCOUNT , RESOURCE или ALL . ACCOUNT — значение по умолчанию.

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

Контекст для данной квоты.

ContextScope -> (строка)

Указывает область, к которой применяется значение квоты. Если область — RESOURCE , значение квоты применяется к каждому ресурсу в учетной записи Amazon Web Services. Если область — ACCOUNT , значение квоты применяется к учетной записи Amazon Web Services.

ContextScopeType -> (строка)

Указывает тип ресурса, к которому может быть применена квота.

ContextId -> (строка)

Указывает ресурс или ресурсы, к которым применяется квота. Значение для этого поля — это либо Идентификатор ресурса Amazon (ARN), либо *. Если значение — ARN, значение квоты применяется к этому ресурсу. Если значение — *, то значение квоты применяется ко всем ресурсам, перечисленным в поле ContextScopeType . Значение квоты применяется ко всем ресурсам, для которых ранее не было применено значение квоты, и к любым новым ресурсам, которые вы создаете в своей учетной записи Amazon Web Services.

Description -> (строка)

Описание квоты.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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