[ aws . service-quotas ]
get-service-quota
Описание
Возвращает значение применённого лимита для указанного лимита на уровне аккаунта или ресурса. Для некоторых лимитов доступны только значения по умолчанию. Если значение применённого лимита для лимита недоступно, лимит не извлекается.
См. также: AWS API документацию
Синтаксис
get-service-quota
--service-code <value>
--quota-code <value>
[--context-id <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]
Параметры
--service-code (строка)
--quota-code (строка)
QuotaCode в ответе для нужного лимита.--context-id (строка)
--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
- text
- таблица
- 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 User Guide.
Если не указано иное, все примеры используют правила цитирования для unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел Использование кавычек со строками в AWS CLI User Guide.
Для описания лимита сервиса
В следующем get-service-quota примере отображаются подробности о заданном лимите.
aws service-quotas get-service-quota \
--service-code ec2 \
--quota-code L-1216C47A
Вывод:
{
"Quota": {
"ServiceCode": "ec2",
"ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)",
"QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:ec2/L-1216C47A",
"QuotaCode": "L-1216C47A",
"QuotaName": "Running On-Demand Standard (A, C, D, H, I, M, R, T, Z) instances",
"Value": 1920.0,
"Unit": "None",
"Adjustable": true,
"GlobalQuota": false,
"UsageMetric": {
"MetricNamespace": "AWS/Usage",
"MetricName": "ResourceCount",
"MetricDimensions": {
"Class": "Standard/OnDemand",
"Resource": "vCPU",
"Service": "EC2",
"Type": "Resource"
},
"MetricStatisticRecommendation": "Maximum"
}
}
}
Вывод
Лимит -> (структура)
Информация о лимите.
ServiceCode -> (строка)
ServiceName -> (строка)
QuotaArn -> (строка)
QuotaCode -> (строка)
QuotaCode в ответе для нужного лимита.QuotaName -> (строка)
Value -> (двойное значение)
Unit -> (строка)
Adjustable -> (булево)
GlobalQuota -> (булево)
UsageMetric -> (структура)
Информация о замерах.
MetricNamespace -> (строка)
MetricName -> (строка)
MetricDimensions -> (массив)
Размеры метрики. Это имя/значение, которое является частью идентификатора метрики.
ключ -> (строка)
значение -> (строка)
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 -> (строка)
ContextScopeType. Значение лимита применяется ко всем ресурсам, для которых ранее не было применено значение лимита, и к любым новым ресурсам, которые вы создаёте в своём аккаунте Amazon Web Services.Description -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.