AWS Marketplace Metering Service による時間単位の計測の設定 - AWS Marketplace
時間単位の計測の前提条件時間単位の計測用の製品ロードフォームRegisterUsage の統合とプレビューモードのテストRegisterUsage でのエラー処理

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS Marketplace Metering Service による時間単位の計測の設定

コンテナ製品でカスタム従量制料金ディメンションの代わりに時間単位、タスク単位またはポッド単位の料金を使用する場合、カスタム計測ディメンションを定義する必要はありません。AWS Marketplace Metering Service を使用して、 のコンテナ製品で時間単位の計測を行うことができます AWS Marketplace。以下のセクションでは、 AWS Marketplace Metering Service で時間単位の計測を設定する方法を示します。

RegisterUsage API オペレーションメーターのソフトウェアは、Amazon Elastic Container Service (Amazon ECS) タスクごと、または Amazon Elastic Kubernetes Service (Amazon EKS) ポッドごとに、1 時間あたりに使用し、使用量は 2 秒に比例配分されます。存続期間の短いタスクやポッドには、最低 1 分の使用量が適用されます。ソフトウェア使用の継続的な計測は、 によって自動的に処理されます。 AWS Marketplace Metering Control Plane。 ソフトウェアは、ソフトウェアの使用を開始するための計測のために 1 RegisterUsage回呼び出すことを除いて、計測固有のアクションを実行する必要はありません。

RegisterUsage はコンテナを起動したらすぐに呼び出す必要があります。コンテナの起動から 6 時間以内にコンテナを登録しない場合、AWSMarketplace Metering Service は過去 か月間の計測保証を提供しません。ただし、計測は当月以降、コンテナが終了するまで継続されます。

の AWS Marketplace Metering Control Plane は、お客様のサブスクリプション状態に関係なく、Amazon ECSタスクと Amazon EKS ポッドの実行に対してお客様に請求を続けます。これにより、タスクまたはポッドが最初に正常に起動した後に、ソフトウェアが使用権限チェックを行う必要がなくなります。

トピック

時間単位の計測の前提条件

製品を公開する前に、次を行う必要があります。

  1. で新しいコンテナ製品を作成し AWS Marketplace 管理ポータル、その製品コードを書き留めます。

    詳細については、「概要: コンテナ製品を作成する」を参照してください。

  2. （ AWS Identity and Access Management IAM) ロールは、 を呼び出すために必要なIAMアクセス許可を持つアプリケーションを実行するタスクまたはポッドに使用しますRegisterUsage。IAM マネージドポリシーAWSMarketplaceMeteringRegisterUsageには、これらのアクセス許可があります。

  3. （オプション) ログ記録を表示する場合は、タスクまたはポッド定義の AWS CloudTrail ログ記録を有効にすることをお勧めします。

  4. 定義したすべての料金ディメンションのレコードを使用して、 RegisterUsageAPIオペレーションをテストコールします。

時間単位の計測用の製品ロードフォーム

時間単位の計測のために製品積載フォームに入力する際、製品を定義するその他の必須フィールドとオプションのフィールドに加えて、製品に関する次のフィールドに入力します。

  • [時間料金] - 製品の 1 時間あたりの料金。

  • [ディメンション長期レート] - 購入者が前払いした場合の、長期契約におけるソフトウェア料金の合計です。

  • [長期期間 (日数)] - 長期契約の期間 (日単位)。

RegisterUsage の統合とプレビューモードのテスト

RegisterUsage API オペレーションを使用して、イメージを公開 AWS Marketplace のために に送信する前に統合をテストします。

プレビューモードは稼働モードと同じように動作しますが、プレビューモードでは製品を使用する権限を確認しません。RegisterUsage プレビューモードで を呼び出すには、Amazon ECSまたは Amazon で製品を実行して、コンテナイメージRegisterUsageから を呼び出しますEKS。 AWS アカウント 使用している を使用して、 に製品を一覧表示します AWS Marketplace。計測統合では、ハードコーディングするのではなく AWS リージョン、動的に を設定する必要があります。ただし、テスト時に、米国東部 (バージニア北部) リージョンで、有料コンテナを含む Amazon ECSタスクまたは Amazon EKS ポッドを少なくとも 1 つ起動します。これにより、 AWS Marketplace オペレーションチームは、そのリージョンのログでの作業を検証できます。

注記

製品が Amazon ECSと Amazon の両方をサポートしている場合はEKS、統合を検証するために Amazon EKS で を起動するだけで済みます。

製品および必要なすべてのメタデータと料金情報が公開されるまでは、統合を完全にテストすることはできません。リクエストされた場合、 AWS Marketplace カタログオペレーションチームは、プレビューモードで計測レコードの受信を確認できます。

RegisterUsage でのエラー処理

コンテナイメージが と統合 AWS Marketplace Metering Service され、コンテナの起動ThrottlingException時以外の例外が発生した場合は、不正使用を防ぐためにコンテナを終了する必要があります。

以外の例外ThrottlingExceptionは、 RegisterUsage API オペレーションへの最初の呼び出しでのみスローされます。同じ Amazon ECSタスクまたは Amazon EKS ポッドからの後続の呼び出しは、タスクまたはポッドの実行中にお客様がサブスクライブを解除CustomerNotSubscribedExceptionしてもスローされません。この顧客は、サブスクリプションを解除した後で使用状況が追跡されると、実行中のコンテナに対して課金されます。

次の表は、RegisterUsageAPIオペレーションがスローする可能性のあるエラーを示しています。各 AWS SDKプログラミング言語には、追加情報として参照できる一連のエラー処理ガイドラインがあります。

エラー 説明
InternalServiceErrorException RegisterUsage は使用できません。
CustomerNotEntitledException 製品の有効なサブスクリプションが顧客にありません。
InvalidProductCodeException リクエストの一部として渡された ProductCode 値が存在しません。
InvalidPublicKeyException リクエストの一部として渡された PublicKeyVersion 値が存在しません。
PlatformNotSupportedException AWS Marketplace は、基盤となるプラットフォームからの計測使用量をサポートしていません。Amazon ECS、Amazon EKS、および のみがサポート AWS Fargate されています。
ThrottlingException RegisterUsage の呼び出しが抑制されます。
InvalidRegionException RegisterUsage は、Amazon ECSタスクまたは Amazon EKS ポッドが起動された AWS リージョン のと同じ で呼び出される必要があります。これにより、RegisterUsage を呼び出す際にコンテナがリージョン (withRegion(“us-east-1”) など) を選択することを防ぎます。