Paylaşım İstatistiklerini Alma
İstek, Get Share Stats paylaşımla ilgili istatistikleri alır. Bu API tam olarak destekleniyor olsa da eski bir yönetim API'sidir. Bu nedenle, bunun yerine depolama kaynak sağlayıcısı (Microsoft.Storage) tarafından sağlanan Dosya Paylaşımları - Al'ı kullanmanızı öneririz.
Depolama kaynak sağlayıcısını kullanarak kaynaklarla FileShare program aracılığıyla etkileşim kurma hakkında daha fazla bilgi edinmek için bkz. Azure Dosyalar paylaşımlarında işlemler.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Kullanılabilir |
|---|---|
| SMB |
|
| NFS |
|
İstek
İstek Get Share Stats aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz.
myaccount değerini depolama hesabınızın adıyla, myshare değerini ise paylaşımınızın adıyla değiştirin.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
| GET | https://myaccount.file.core.windows.net/myshare?restype=share&comp=stats |
HTTP/1.1 |
URI parametreleri
İstek URI'sinde aşağıdaki ek parametreler belirtilebilir:
| Parametre | Açıklama |
|---|---|
timeout |
İsteğe bağlı. Zaman aşımı parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için zaman aşımlarını ayarlama. |
İstek üst bilgileri
Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:
| İstek üst bilgisi | Açıklama |
|---|---|
Authorization |
Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
Date veya x-ms-date |
Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
x-ms-version |
Tüm yetkili istekler için gereklidir. Sürüm 2015-02-21 ve üzeri. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
x-ms-client-request-id |
İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Dosyalar. |
x-ms-lease-id:<ID> |
İsteğe bağlı. Sürüm 2020-02-10 ve üzeri. Üst bilgi belirtilirse, işlem yalnızca dosya paylaşımının kirası şu anda etkinse ve istekte belirtilen kira kimliği dosya paylaşımının kira kimliğiyle eşleşiyorsa gerçekleştirilir. Eşleşme yoksa işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu). |
İstek gövdesi
Yok.
Yanıt
Yanıt ve HTTP durum kodunu, yanıt üst bilgilerini ve yanıt gövdesini içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.
Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.
| Yanıt üst bilgisi | Description |
|---|---|
Last-Modified |
Paylaşımın en son değiştirildiği tarihi ve saati döndürür. Tarih biçimi RFC 1123'e göredir. Daha fazla bilgi için bkz. Üst bilgilerde tarih/saat değerlerini temsil edin. Paylaşımı veya özelliklerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. Dosyalardaki işlemler paylaşımın son değiştirme zamanını etkilemez. |
ETag |
İşlemleri koşullu olarak gerçekleştirmek için kullanabileceğiniz bir değer içerir. Değer tırnak içine alınır. |
x-ms-request-id |
Yapılan isteği benzersiz olarak tanımlar ve istekle ilgili sorunları gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme. |
x-ms-version |
İsteği yürütmek için kullanılan Azure Dosyalar sürümünü gösterir. |
Date |
Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri. |
x-ms-client-request-id |
İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir.
x-ms-client-request-id Üst bilgi istekte yoksa yanıtta bulunmaz. |
Yanıt gövdesi
Yanıt gövdesinin biçimi aşağıdaki gibidir:
<?xml version="1.0" encoding="utf-8"?>
<ShareStats>
<ShareUsageBytes>8189134192</ShareUsageBytes>
</ShareStats>
| Öğe | Açıklama |
|---|---|
ShareUsageBytes |
Paylaşımda depolanan verilerin yaklaşık boyutu. Bu değerin son oluşturulan veya yakın zamanda yeniden boyutlandırılan tüm dosyaları içeremediğini unutmayın. |
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Paylaşım anlık görüntüsü istatistikleri alınamıyor. Paylaşım anlık görüntüsü istatistiklerini almaya çalışılırsa, hizmet durum kodu 400 (Geçersiz Sorgu Parametresi Değeri) döndürür.
2018-11-09 sürümünden itibaren ShareUsage yanıt öğesi ile ShareUsageBytesdeğiştirildi.
ShareUsage , paylaşımda depolanan verilerin yaklaşık boyutudur ve en yakın gibibayta (GiB) yuvarlanır.