ローカルの使用状況測定を使用して、Azure Stack の使用状況を分析する - Modular Data Center (MDC)

どのサブスクリプションがどのリソースを使用しているかに関する情報は、ローカルの使用状況データベースに格納されています。 管理者はこのデータを取得して、リソースを使用しているユーザーを分析できます。

API 呼び出しリファレンス

Request

要求は、要求されたサブスクリプションと要求された期間の使用の詳細を取得します。 要求の本文はありません。

この使用状況 API はプロバイダー API であるため、呼び出し元に、プロバイダーのサブスクリプションの所有者共同作成者、または閲覧者の役割が割り当てられている必要があります。

Method 要求 URI
GET https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&subscriberId={sub1.1}&api-version=2015-06-01-preview&continuationToken={token-value}

引数

引数 説明
armendpoint Azure Stack 環境の Azure Resource Manager エンドポイント。 Azure Stack 規則は、Azure Resource Manager エンドポイントの名前が、https://adminmanagement.{domain-name} の形式であることです。
subId 呼び出しを行っているユーザーのサブスクリプション ID。
reportedStartTime クエリの開始時間。 DateTime の値は協定世界時 (UTC) で、13:00 など、毎時 0 分に設定する必要があります。 毎日の集計では、この値を UTC の午前 0 時に設定します。 形式はエスケープされた ISO 8601 (たとえば、2015-06-16T18%3a53%3a11%2b00%3a00Z など) です。URI に対応できるように、コロンは %3a に、プラスは %2b にエスケープされます。
reportedEndTime クエリの終了時間。 reportedStartTime に適用される制約は、この引数にも適用されます。 reportedEndTime の値は、将来、または現在の日付にすることはできません。 そうすると、結果は "処理が未完了" に設定されます。
aggregationGranularity dailyhourly の 2 つの個別の指定可能な値を持つ省略可能なパラメーター。 値が示すように、一方は日単位の粒度でデータを返し、もう一方は時間単位の解像度です。 daily オプションが既定値です。
subscriberId [サブスクリプション ID] が表示されます。 フィルター処理されたデータを取得するには、プロバイダーの直接のテナントのサブスクリプション ID が必要です。 サブスクリプション ID パラメーターが指定されていない場合、呼び出しは、すべてのプロバイダーの直接のテナントの使用状況データを返します。
api-version この要求を行うために使用するプロトコルのバージョン。 この値は 2015-06-01-preview に設定されます。
continuationToken 使用状況 API プロバイダーへの最後の呼び出しから取得されたトークン。 このトークンは、応答が 1,000 行より大きい場合に必要であり、 進行状況のブックマークとして機能します。 トークンが存在しない場合は、渡された細分性に基づいて、日または時間の開始点からのデータが取得されます。

Response

GET
/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0
{
"value": [
{

"id":
"/subscriptions/sub1.1/providers/Microsoft.Commerce.Admin/UsageAggregate/sub1.1-

meterID1",
"name": "sub1.1-meterID1",
"type": "Microsoft.Commerce.Admin/UsageAggregate",

"properties": {
"subscriptionId":"sub1.1",
"usageStartTime": "2015-03-03T00:00:00+00:00",
"usageEndTime": "2015-03-04T00:00:00+00:00",
"instanceData":"{\"Microsoft.Resources\":{\"resourceUri\":\"resourceUri1\",\"location\":\"Alaska\",\"tags\":null,\"additionalInfo\":null}}",
"quantity":2.4000000000,
"meterId":"meterID1"

}
},

. . .

応答の詳細

引数 説明
id 使用状況集計の一意の ID
name 使用状況集計の名前
type リソース定義
subscriptionId Azure Stack ユーザーのサブスクリプション識別子
usageStartTime この使用状況集計が属する使用状況バケットの UTC 開始時間
usageEndTime この使用状況集計が属する使用状況バケットの UTC 終了時間
instanceData インスタンスの詳細のキーと値のペア (新しい形式)。
resourceUri:完全修飾リソース ID。リソース グループとインスタンス名が含まれます。
location:このサービスが実行されたリージョン。
tags:ユーザーによって指定されたリソース タグ。
additionalInfo:OS のバージョンやイメージの種類など、使用されたリソースの詳細。
quantity この期間に発生したリソース使用量
meterId 使用されたリソースの一意の ID (ResourceID とも呼ばれます)。

使用量情報を取得する

PowerShell

使用量データを生成するには、実行されていて、システムをアクティブに使っているリソース (アクティブな仮想マシン (VM) や、データを格納しているストレージ アカウントなど) が必要です。 Azure Stack Marketplace で実行されているリソースがあるかどうかが不明な場合は、VM をデプロイし、実行されているかどうか VM 監視ブレードを確認します。 使用量データを表示するには、次の PowerShell コマンドレットを使用します。

  1. PowerShell for Azure Stack をインストールします

  2. Azure Stack ユーザーまたは Azure Stack オペレーターの PowerShell 環境を構成します。

  3. 使用状況データを取得するには、Get-AzsSubscriberUsage PowerShell コマンドレットを呼び出します。

    Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"
    

REST API

Microsoft.Commerce.Admin サービスを呼び出すことで、削除されたサブスクリプションの利用状況情報を収集できます。

アクティブ ユーザーに対して削除されたすべてのテナントの使用状況を返す

Method 要求 URI
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview

削除済みまたはアクティブなテナントの使用状況を返す

Method 要求 URI
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&subscriberId={subscriber-id}&api-version=2015-06-01-preview