Pool - Get All Lifetime Statistics

取得指定帳戶中所有集區的存留期摘要統計資料。
統計資料會匯總到帳戶中曾經存在的所有集區,從帳戶建立到統計資料的上次更新時間。 統計資料可能無法立即使用。 Batch 服務會定期匯總統計資料。 一般的延遲約為30分鐘。

GET {batchUrl}/lifetimepoolstats?api-version=2020-09-01.12.0
GET {batchUrl}/lifetimepoolstats?timeout={timeout}&api-version=2020-09-01.12.0

URI 參數

Name In Required Type Description
batchUrl
path True
  • string

所有 Azure Batch 服務要求的基底 URL。

api-version
query True
  • string

用戶端 API 版本。

timeout
query
  • integer
int32

伺服器可花費在處理要求的時間上限(以秒為單位)。 預設值為 30 秒。

要求標頭

Media Types: "application/json; odata=minimalmetadata"

Name Required Type Description
client-request-id
  • string
uuid

呼叫端產生的要求身分識別,以 GUID 的形式呈現,沒有任何裝飾,例如大括弧,例如9C4D50EE-2D56-4CD3-8152-34347DC9F2B0。

return-client-request-id
  • boolean

伺服器是否應在回應中傳回用戶端要求識別碼。

ocp-date
  • string
date-time-rfc1123

發出要求的時間。 用戶端程式庫通常會將此設定為目前的系統時鐘時間;如果您直接呼叫 REST API,請明確設定它。

回應

Name Type Description
200 OK

包含 Batch 帳戶存留期之集區統計資料的回應。

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

來自 Batch 服務的錯誤。

安全性

azure_auth

Azure Active Directory OAuth2 流程

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 模擬您的使用者帳戶

Authorization

Type: apiKey
In: header

範例

Pool get lifetime statistics

Sample Request

GET account.region.batch.azure.com/lifetimepoolstats?api-version=2020-09-01.12.0
client-request-id: 00000000-0000-0000-0000-000000000000
ocp-date: Fri, 17 Feb 2017 00:00:00 GMT

Sample Response

{
  "url": "https://account.region.batch.core.windows.net/lifetimepoolstats",
  "startTime": "2014-08-01T18:30:00.4345729Z",
  "lastUpdateTime": "2014-08-04T18:30:00.4345729Z",
  "usageStats": {
    "startTime": "2014-08-01T18:30:00.4345729Z",
    "lastUpdateTime": "2014-08-04T18:30:00.4345729Z",
    "dedicatedCoreTime": "PT0S"
  },
  "resourceStats": {
    "startTime": "2014-08-01T18:30:00.4345729Z",
    "lastUpdateTime": "2014-08-04T18:30:00.4345729Z",
    "avgCPUPercentage": 40,
    "avgMemoryGiB": 2,
    "peakMemoryGiB": 4,
    "avgDiskGiB": 125,
    "peakDiskGiB": 240,
    "diskReadIOps": 0,
    "diskWriteIOps": 0,
    "diskReadGiB": 10,
    "diskWriteGiB": 1,
    "networkReadGiB": 20,
    "networkWriteGiB": 25
  }
}

定義

BatchError

從 Azure Batch 服務收到的錯誤回應。

BatchErrorDetail

包含在 Azure Batch 錯誤回應中的其他資訊專案。

ErrorMessage

在 Azure Batch 錯誤回應中收到的錯誤訊息。

PoolStatistics

包含集區存留期的使用率和資源使用量統計資料。

ResourceStatistics

集區中計算節點的資源耗用量相關統計資料。

UsageStatistics

與集區使用量資訊相關的統計資料。

BatchError

從 Azure Batch 服務收到的錯誤回應。

Name Type Description
code
  • string

錯誤的識別碼。 程式碼是不變的,旨在以程式設計的方式取用。

message

描述錯誤的訊息,其適用于在使用者介面中顯示。

values

機碼值組的集合,其中包含有關錯誤的其他詳細資料。

BatchErrorDetail

包含在 Azure Batch 錯誤回應中的其他資訊專案。

Name Type Description
key
  • string

指定 Value 屬性之意義的識別碼。

value
  • string

錯誤回應中所包含的其他資訊。

ErrorMessage

在 Azure Batch 錯誤回應中收到的錯誤訊息。

Name Type Description
lang
  • string

錯誤訊息的語言代碼

value
  • string

訊息的文字。

PoolStatistics

包含集區存留期的使用率和資源使用量統計資料。

Name Type Description
lastUpdateTime
  • string

上次更新統計資料的時間。 所有統計資料僅限於 startTime 與 lastUpdateTime 之間的範圍。

resourceStats

集區中計算節點的資源耗用量相關統計資料。

startTime
  • string

統計資料所涵蓋之時間範圍的開始時間。

url
  • string

統計資料的 URL。

usageStats

與集區使用量相關的統計資料,例如使用的核心時間量。

ResourceStatistics

集區中計算節點的資源耗用量相關統計資料。

Name Type Description
avgCPUPercentage
  • number

集區中所有計算節點的平均 CPU 使用率, (每個節點) 的百分比。

avgDiskGiB
  • number

在集區中的所有計算節點之間,GiB 中的平均使用磁碟空間。

avgMemoryGiB
  • number

集區中所有計算節點之間的平均記憶體使用量 GiB。

diskReadGiB
  • number

在集區中的所有計算節點上,磁片讀取 GiB 中的總數據量。

diskReadIOps
  • integer

集區中所有計算節點上的磁片讀取作業總數。

diskWriteGiB
  • number

在集區中的所有計算節點上,磁片寫入 GiB 中的總數據量。

diskWriteIOps
  • integer

集區中所有計算節點上的磁片寫入作業總數。

lastUpdateTime
  • string

上次更新統計資料的時間。 所有統計資料僅限於 startTime 與 lastUpdateTime 之間的範圍。

networkReadGiB
  • number

在集區中的所有計算節點上,網路讀取 GiB 中的總數據量。

networkWriteGiB
  • number

在集區中的所有計算節點上,網路寫入 GiB 中的總數據量。

peakDiskGiB
  • number

在集區中所有計算節點的 GiB 中,使用的磁碟空間量。

peakMemoryGiB
  • number

集區中所有計算節點之間的 GiB 尖峰記憶體使用量。

startTime
  • string

統計資料所涵蓋之時間範圍的開始時間。

UsageStatistics

與集區使用量資訊相關的統計資料。

Name Type Description
dedicatedCoreTime
  • string

屬於集區一部分的專用計算節點核心的匯總時鐘時間。

lastUpdateTime
  • string

上次更新統計資料的時間。 所有統計資料僅限於 startTime 與 lastUpdateTime 之間的範圍。

startTime
  • string

統計資料所涵蓋之時間範圍的開始時間。