從資源提供者擷取使用量資料
適用于：Windows Azure Pack
從資源提供者擷取使用量資料。
要求
將 UsageEndpoint > 取代 < 為 Windows Azure Pack 自訂資源提供者使用量 REST API 的端點位址。
方法 |
要求 URI |
HTTP 版本 |
|---|---|---|
GET |
<HTTPs:// UsageEndpoint > /usage |
HTTP/1.1 |
URI 參數
下表描述 URI 參數。
URI 參數 |
說明 |
|---|---|
lastID |
使用量收集器所接收的最後一筆記錄識別碼。 第一個要求的 lastID 參數是空的。 這是使用收集器辨識先前記錄的通知，因此可以刪除這些記錄。 |
BatchSize |
要傳送至使用收集器的新記錄數目。 新記錄是遵循 lastID 參數所識別記錄的記錄。 資源提供者可以傳送比要求較小的批次，但無法傳送較大的批次。 |
要求標頭
下表描述必要的和選用的要求標頭。
要求標頭 |
描述 |
|---|---|
授權：持有人 |
必要。 授權持有人權杖。 |
x-ms-principal-id |
必要。 主體識別碼。 |
x-ms-client-request-id |
選擇性。 用戶端要求識別碼。 |
x-ms-client-session-id |
選擇性。 用戶端會話識別碼。 |
x-ms-principal-liveid |
選擇性。 主體 Live 識別碼。 |
要求本文
無。
回應
回應包括 HTTP 狀態碼、一組回應標頭和回應主體。
狀態碼
成功的作業會傳回狀態碼 200 (OK)。
如需狀態碼的相關資訊，請參閱狀態和錯誤碼 (Windows Azure Pack Service Management) 。
回應標頭
此作業的回應包含標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格。
回應本文
下表描述回應主體的重要元素：
元素名稱 |
描述 |
|---|---|
EventId |
必要。 代表每個使用記錄的唯一識別碼。 此值會比對 lastID URI 參數的值。 |
ResourceId |
選擇性。 如果資源提供者有多個資源供單一訂用帳戶使用，且使用量正在匯總資源，則此欄位可用來指定資源名稱。 如果使用量是由訂用帳戶識別碼匯總，則不會使用這個專案。 |
StartTime |
必要。 指出何時開始收集使用量資料。 |
EndTime |
必要。 指出使用量資料的收集何時結束。 |
ServiceType |
必要。 已取用的服務層級。 |
SubscriptionId |
必要。 收集使用量資料的訂用帳戶識別碼。 (GUID) 。 |
屬性 |
選擇性。 名稱/值組的字典，用來傳遞有關使用方式的任何其他資訊。 |
資源 |
必要。 名稱/值組的字典，表示已配置或取用的資源。 例如，SQL資源提供者可能會有總空間和資料庫計數作為其計量。 |
備註
使用收集器會定期從資源提供者擷取使用量資料，以收集資源提供者的使用資訊。 這項資訊可用來產生資源提供者使用量的計費成本。 如需詳細資訊， 請參閱自訂資源提供者端點。 如需 azure Pack Usage Service Windows的詳細資訊，請參閱Windows Azure Pack Usage Service。