Spec-Zone.ru › AWS CLI v2

[ aws . meteringmarketplace ]

meter-usage

Описание

API для вывода записей об использовании. Для идентичных запросов API является идемпотентным и возвращает идентификатор записи об использовании. Это используется для измерения гибкой ценовой политики потребления (FCP) Amazon Machine Images (AMI) и контейнерных продуктов.

MeterUsage аутентифицируется на учетной записи Amazon Web Services покупателя с использованием учетных данных из экземпляра Amazon EC2, задачи Amazon ECS или под Amazon EKS.

MeterUsage может необязательно включать несколько распределений использования, чтобы предоставить клиентам данные об использовании, разделенные по меткам, которые вы определяете (или позволяете определять клиенту).

Записи об использовании должны быть отправлены как можно быстрее после события, которое регистрируется, и не принимаются более чем через 6 часов после события.

Для областей Amazon Web Services, которые поддерживают MeterUsage, см. Поддержка региона MeterUsage для Amazon EC2 и Поддержка региона MeterUsage для Amazon ECS и Amazon EKS.

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

Синтаксис

  meter-usage
--product-code <value>
--timestamp <value>
--usage-dimension <value>
[--usage-quantity <value>]
[--dry-run | --no-dry-run]
[--usage-allocations <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]

Параметры

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

Код продукта используется для уникальной идентификации продукта в Amazon Web Services Marketplace. Код продукта должен быть таким же, как тот, который использовался при публикации нового продукта.

--timestamp (отметка времени)

Отметка времени в UTC, для которой сообщается информация об использовании. Ваше приложение может измерять использование за последние шесть часов. Убедитесь, что значение timestamp не предшествует началу использования программного обеспечения.

--usage-dimension (строка)

Это будет одно из имён размерностей fcp, предоставленных во время публикации продукта.

--usage-quantity (целое число)

Значение потребления за час. По умолчанию устанавливается значение 0, если не указано иное.

--dry-run | --no-dry-run (булево)

Проверяет, есть ли у вас разрешения, необходимые для действия, но не выполняет запрос. Если у вас есть разрешения, запрос возвращает DryRunOperation; в противном случае возвращает UnauthorizedException. По умолчанию устанавливается значение false, если не указано иное.

--usage-allocations (список)

Набор UsageAllocations для отправки.

Сумма всех значений UsageAllocation должна равняться значению UsageQuantity запроса MeterUsage, и каждый UsageAllocation должен иметь уникальный набор тегов (не включать теги).

(структура)

Распределения использования позволяют разделять использование на ведра по тегам.

Каждый UsageAllocation указывает количество использования для определенного набора тегов.

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

Общее количество, выделенное для этого ведра использования.

Tags -> (список)

Набор тегов, определяющих ведро использования. Для ведра элементов без тегов этот параметр можно опустить.

(структура)

Метаданные, назначенные распределению. Каждый тег состоит из key и value.

Key -> (строка)

Одна часть пары ключ-значение, которая образует tag. key — это метка, которая действует как категория для конкретных значений тегов.

Value -> (строка)

Одна часть пары ключ-значение, которая образует tag. value действует как описатель в категории тегов (ключ). Значение может быть пустым или нулевым.

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

AllocatedUsageQuantity=integer,Tags=[{Key=string,Value=string},{Key=string,Value=string}] ...

Синтаксис JSON:

[
  {
    "AllocatedUsageQuantity": integer,
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
  ...
]

--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
  • текст
  • таблица
  • 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-auto-prompt (булево)

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

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

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

Вывод

MeteringRecordId -> (строка)

Идентификатор записи об использовании.

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

Spec-Zone.ru

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