describe-instance-credit-specifications

Описание

Описывает вариант кредитования для использования процессорного времени указанных виртуальных машин с возможностью бурстного увеличения производительности. Варианты кредитования — standard и unlimited.

Если вы не укажете идентификатор экземпляра, Amazon EC2 вернёт виртуальные машины с возможностью бурстного увеличения производительности с вариантом кредитования unlimited, а также экземпляры, которые ранее были настроены как T2, T3 и T3a, с вариантом кредитования unlimited. Например, если вы измените размер виртуальной машины T2, при этом она настроена как unlimited, на виртуальную машину M4, Amazon EC2 вернёт виртуальную машину M4.

Если вы укажете один или несколько идентификаторов экземпляров, Amazon EC2 вернёт вариант кредитования (standard или unlimited) этих экземпляров. Если вы укажете недействительный идентификатор экземпляра, например, экземпляр, который не является виртуальной машиной с возможностью бурстного увеличения производительности, будет возвращена ошибка.

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

Если в какой-либо зоне доступности происходит сбой службы и вы укажете идентификаторы экземпляров в этой зоне или не укажете никаких идентификаторов экземпляров, вызов завершится ошибкой. Если вы укажете только идентификаторы экземпляров в незатронутой зоне, вызов выполнится нормально.

Дополнительную информацию см. в разделе Виртуальные машины с возможностью бурстного увеличения производительности в руководстве пользователя Amazon EC2.

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

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

Синтаксис

  describe-instance-credit-specifications
[--dry-run | --no-dry-run]
[--filters <value>]
[--instance-ids <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]

Параметры

--dry-run | --no-dry-run (boolean)

--filters (список)

Сокращённый синтаксис:

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

--instance-ids (список)

Синтаксис:

"string" "string" ...

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

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

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

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

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

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (строка)

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

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

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

• on
• off
• auto

--no-sign-request (boolean)

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

--ca-bundle (строка)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 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 (boolean)

Отключить постраничный вывод cli для вывода.

--cli-auto-prompt (boolean)

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

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

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

Примеры

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

В следующем describe-instance-credit-specifications примере описывается вариант кредитования для использования процессорного времени указанного экземпляра.

aws ec2 describe-instance-credit-specifications \
    --instance-ids i-1234567890abcdef0

Вывод:

{
    "InstanceCreditSpecifications": [
        {
            "InstanceId": "i-1234567890abcdef0",
            "CpuCredits": "unlimited"
        }
    ]
}

Дополнительную информацию см. в разделе Работа с виртуальными машинами с возможностью бурстного увеличения производительности в руководстве пользователя Amazon EC2.

Вывод

InstanceCreditSpecifications -> (список)

NextToken -> (строка)