取得共用統計資料

  • 發行項

要求 Get Share Stats 會擷取與共享相關的統計資料。 雖然完全支援此 API，但它是舊版管理 API。 基於這個理由，建議您改用 檔案共用 - Get，這是由儲存體資源提供者提供， (Microsoft.Storage) 。

若要深入瞭解如何使用儲存體資源提供者以程式設計方式與 FileShare 資源互動，請參閱Azure 檔案儲存體共用上的作業。

通訊協定可用性

已啟用檔案共用通訊協定 可用
SMB 是
NFS 是

要求

Get Share Stats 要求的建構如下。 建議您使用 HTTPS。 將 myaccount 取代為您的儲存體帳戶名稱，並以您的共用名稱稱取代 myshare 。

方法 要求 URI HTTP 版本
GET https://myaccount.file.core.windows.net/myshare?restype=share&comp=stats HTTP/1.1

URI 參數

您可以在要求 URI 中指定下列額外的參數：

參數 描述
timeout 選擇性。 timeout 參數以秒為單位。 如需詳細資訊，請參閱設定Azure 檔案儲存體作業的逾時。

要求標頭

下表說明必要的和選擇性要求標頭：

要求標頭 描述
Authorization 必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
Date 或 x-ms-date 必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
x-ms-version 所有已授權要求都需要。 版本 2015-02-21 和更新版本。 指定用於這個要求的作業版本。

如需詳細資訊，請參閱 Azure 儲存體服務的版本。
x-ms-client-request-id 選擇性。 提供用戶端產生的不透明值，其中包含設定記錄時記錄的 1 kibibyte (KiB) 字元限制。 強烈建議您使用此標頭，將用戶端活動與伺服器接收的要求相互關聯。 如需詳細資訊，請參閱監視Azure 檔案儲存體。
x-ms-lease-id:<ID> 選擇性。 版本 2020-02-10 和更新版本。 如果指定標頭，則只有在檔案共用的租用目前為作用中，且要求中指定的租用識別碼符合檔案共用的租用識別碼時，才會執行作業。 如果沒有相符專案，作業會失敗，狀態碼為 412 (前置條件失敗) 。

要求本文

無。

回應

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

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

如需狀態碼的相關資訊，請參閱 狀態和錯誤碼。

回應標頭

這項作業的回應包括下列標頭。 回應也可能包含額外的標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格。

回應標頭 描述
Last-Modified 傳回上次修改共用的日期和時間。 日期格式會依照 RFC 1123。 如需詳細資訊，請參閱 在標頭中代表日期/時間值。 修改共用或其屬性的任何作業，都會更新上次修改時間。 對檔案執行作業不會影響上次修改共用的時間。
ETag 包含可用來有條件地執行作業的值。 此值會以引號括住。
x-ms-request-id 可唯一識別發出的要求，並可用來對要求進行疑難排解。 如需詳細資訊，請參閱 針對 API 作業進行疑難排解。
x-ms-version 指出用來執行要求的Azure 檔案儲存體版本。
Date 服務所產生的 UTC 日期/時間值，表示起始回應的時間。
x-ms-client-request-id 可用來針對要求及其對應的回應進行疑難排解。 如果此標頭存在於要求中，且值包含不超過 1，024 個可見的 ASCII 字元，則此標頭的值等於 標頭的值 x-ms-client-request-id 。 x-ms-client-request-id如果要求中沒有標頭，它就不會出現在回應中。

回應本文

回應主體的格式如下：

<?xml version="1.0" encoding="utf-8"?>  
<ShareStats>  
   <ShareUsageBytes>8189134192</ShareUsageBytes>  
</ShareStats>
元素 Description
ShareUsageBytes 儲存在共用上的大約資料大小。 請注意，此值可能不會包含最近建立或最近調整大小的檔案。

授權

只有帳戶擁有者可呼叫這項作業。

備註

無法擷取共用快照集的統計資料。 如果嘗試擷取共用快照集統計資料，服務會傳回狀態碼 400 (不正確查詢參數值) 。

自 2018-11-09 版起， ShareUsage 回應元素已取代為 ShareUsageBytes 。 ShareUsage 是儲存在共用上的大約資料大小，四捨五入為最接近的 gibibyte (GiB) 。

另請參閱

Azure 檔案共用上的作業