擷取附加元件的計量

發行項
08/24/2015

適用于：Windows Azure Pack

從指定的開始日期擷取附加元件計量到指定的結束日期。

要求

以您的服務管理 API 端點位址取代 < ServiceMgmt > 。將 AddonId > 取代 < 為所收集計量的附加元件識別碼。

方法	要求 URI	HTTP 版本
GET	<HTTPs:// ServiceMgmt > ：30004/addons/ < AddonId > /metrics	HTTP/1.1

URI 參數

下表描述 URI 參數。

URI 參數	Description
startTime	必要。要開始收集計量的 DateTime。
endTime	必要。停止收集計量的 DateTime。

要求標頭

下表描述必要的和選用的要求標頭。

要求標頭	描述
授權：持有人	必要。授權持有人權杖。
x-ms-principal-id	必要。主體識別碼。
x-ms-client-request-id	選擇性。用戶端要求識別碼。
x-ms-client-session-id	選擇性。用戶端會話識別碼。
x-ms-principal-liveid	選擇性。主體 Live 識別碼。

要求本文

無。

回應

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。如果 URI 參數不正確，則傳回 404。

如需狀態碼的相關資訊，請參閱狀態和錯誤碼 (Windows Azure Pack Service Management) 。

回應標頭

此作業的回應包含標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格。

回應本文

下表描述回應本文的元素。

名稱

計量名稱。這包括「DailySignupCount」或「TotalSignupCount」。

PrimaryAggregationType

計量主要匯總類型。值包括「Total」

ConfigState

計量單位。值包括「Bytes」 BytesPerSec「，」Count「，」Megabytes「，」Milliseconds「，」Other「，」Percentage「，」Seconds」。

TimeGrain

計量時間粒紋。

StartTime

傳回之計量值集的開始時間。

EndTime

傳回之計量值集的結束時間。

值

計量值的清單。如果是「Count」匯總類型，則會使用下列格式：

元素名稱	Description
建立時間	記錄計量值的 DateTime。
總計	針對「DailySignUp」 - 記錄的每日註冊總數。針對「TotalSignUp」註冊總數。
最小值	最小值
最大值	最大值
Count	值計數

範例

下列程式碼範例顯示 附加元件計量 要求。

GET https://<Computer>:30004/addons/GoldAhihps8jy/metrics?startTime=2013-06-22T07%3a00%3a00.0000000Z&endTime=2013-06-29T07%3a00%3a00.0000000Z HTTP/1.1
Authorization: Bearer <Token>
x-ms-client-request-id: 5b933374-0387-4f5d-8bce-13f5c067d54b-2013-06-28 18:30:18Z
x-ms-client-session-id: d19ca528-d7bf-4a62-9d4d-03adbb4f6c74
x-ms-principal-id: <COMPUTER>\Administrator
Accept-Language: en-US
x-ms-principal-liveid: <COMPUTER>\Administrator
Host: <Computer>:30004

下列程式碼範例顯示 [新增附加元件計量] 回應。

[
  {
    "Name": "DailySignupCount",
    "PrimaryAggregationType": "Total",
    "Unit": "Count",
    "TimeGrain": "1.00:00:00",
    "StartTime": "2013-06-22T07:00:00Z",
    "EndTime": "2013-06-29T07:00:00Z",
    "Values": [
      {
        "TimeCreated": "2013-06-22T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      },
      {
        "TimeCreated": "2013-06-23T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      },
      {
        "TimeCreated": "2013-06-28T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      }
    ]
  },
  {
    "Name": "TotalSignupCount",
    "PrimaryAggregationType": "Total",
    "Unit": "Count",
    "TimeGrain": "1.00:00:00",
    "StartTime": "2013-06-22T07:00:00Z",
    "EndTime": "2013-06-29T07:00:00Z",
    "Values": [
      {
        "TimeCreated": "2013-06-22T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      },
      {
        "TimeCreated": "2013-06-27T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      },
      {
        "TimeCreated": "2013-06-28T07:00:00Z",
        "Total": 0,
        "Minimum": null,
        "Maximum": null,
        "Count": 1
      }
    ]
  }
]

另請參閱

系統管理員附加元件介面

共用方式為