register-usage

Описание

Продукты программного обеспечения контейнеров, продаваемые через Amazon Web Services Marketplace, должны интегрироваться с Amazon Web Services Marketplace Metering Service и вызывать операцию RegisterUsage для получения права использования и учета. Бесплатные и BYOL-продукты для Amazon ECS или Amazon EKS не обязаны вызывать RegisterUsage, но вы можете это сделать, если хотите получать данные об использовании в своих отчетах о продажах. Разделы ниже объясняют поведение RegisterUsage. RegisterUsage выполняет две основные функции: учет и право доступа.

• Право доступа : RegisterUsage позволяет проверить, подписан ли клиент, использующий ваш платный программный продукт, на ваш продукт в Amazon Web Services Marketplace, что позволяет защититься от несанкционированного использования. Вашему образу контейнера, интегрированному с RegisterUsage, требуется только защита от несанкционированного использования при запуске контейнера, поскольку исключение CustomerNotSubscribedException или PlatformNotSupportedException будет выброшено только при первом вызове RegisterUsage. Последующие вызовы от того же экземпляра задачи Amazon ECS (например, идентификатор задачи) или контейнера Amazon EKS не будут вызывать CustomerNotSubscribedException, даже если клиент отменит подписку, пока задача Amazon ECS или контейнер Amazon EKS все еще работают.
• Учет : RegisterUsage учитывает использование программного обеспечения на задачу ECS, в час или на контейнер Amazon EKS с учетом использования, пропорционально секундам. Минимальное время использования составляет 1 минуту для задач с коротким временем работы. Например, если у клиента есть кластер Amazon ECS или Amazon EKS из 10 узлов и служба, настроенная как Daemon Set, то Amazon ECS или Amazon EKS запустит задачу на всех 10 узлах кластера, и с клиента будет взиматься плата за 10 задач. Учет программного обеспечения выполняется контрольной плоскостью учета Amazon Web Services Marketplace — вашему программному обеспечению не требуется выполнять действия, специфичные для учета, кроме как вызова RegisterUsage для начала учета. Amazon Web Services Marketplace metering control plane также будет взимать плату с клиентов за запуск задач ECS и контейнеров Amazon EKS независимо от состояния подписки клиента, что устраняет необходимость для вашего программного обеспечения выполнять проверки права доступа во время выполнения. Для контейнеров, RegisterUsage должен быть вызван немедленно при запуске. Если вы не зарегистрируете контейнер в течение первых 6 часов после запуска, Amazon Web Services Marketplace Metering Service не предоставляет никаких гарантий учета за предыдущие месяцы. Однако учет будет продолжен для текущего месяца до завершения контейнера. RegisterUsage предназначен для учета платных почасовых продуктов контейнеров. Для регионов Amazon Web Services, которые поддерживают RegisterUsage, см. Поддержка регионов RegisterUsage.

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

Синопсис

  register-usage
--product-code <value>
--public-key-version <value>
[--nonce <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 (строка)

--public-key-version (целое число)

--nonce (строка)

--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 для вывода.

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

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

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

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

Вывод

PublicKeyRotationTimestamp -> (метка времени)

Подпись -> (строка)