Dapatkan Statistik Blob Service

Operasi ini Get Blob Service Stats mengambil statistik yang terkait dengan replikasi untuk Azure Blob Storage. Operasi ini hanya tersedia di titik akhir lokasi sekunder ketika replikasi geo-redundan akses baca diaktifkan untuk akun penyimpanan.

Minta

Anda dapat membuat Get Blob Service Stats permintaan sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS. Ganti myaccount dengan nama akun penyimpanan Anda, dan perhatikan bahwa akhiran -secondary diperlukan:

Metode Meminta URI Versi HTTP
GET https://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1

Catatan

URI harus selalu menyertakan garis miring (/) untuk memisahkan nama host dari jalur dan bagian kueri. Dalam kasus operasi ini, bagian jalur URI kosong.

Parameter URI

Anda dapat menentukan parameter tambahan berikut pada permintaan URI:

Parameter Deskripsi
Timeout Opsional. Parameter timeout dinyatakan dalam hitung detik.

Header permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Meminta kop Deskripsi
Authorization Wajib diisi. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
Date or x-ms-date Wajib diisi. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
x-ms-version Diperlukan untuk semua permintaan yang diotorisasi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
x-ms-client-request-id Opsional. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB) yang dicatat dalam log saat pengelogan dikonfigurasi. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server. Untuk informasi selengkapnya, lihat Memantau Azure Blob Storage.

Isi permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons

Kode status

Operasi yang berhasil mengembalikan kode status 200 (OK). Ketika operasi dipanggil pada titik akhir lokasi sekunder yang tidak diaktifkan untuk baca sekunder, operasi mengembalikan kode status HTTP 403 dengan kesalahan InsufficientAccountPermissions .

Header respons

Respons untuk operasi ini mencakup header berikut. Respons juga mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header respons Deskripsi
x-ms-request-id Secara unik mengidentifikasi permintaan yang dibuat, dan Anda dapat menggunakannya untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan masalah operasi API.
x-ms-version Menentukan versi operasi yang digunakan untuk respons. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
Date Nilai tanggal/waktu UTC yang dihasilkan oleh layanan, yang menunjukkan waktu ketika respons dimulai.
x-ms-client-request-id Dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai x-ms-client-request-id header jika ada dalam permintaan dan nilai tidak lebih dari 1.024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header ini tidak ada dalam respons.

Isi Respons

Format isi respons adalah sebagai berikut:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>        
      <Status>live|bootstrap|unavailable</Status>  
      <LastSyncTime>sync-time|<empty></LastSyncTime>  
  </GeoReplication>  
</StorageServiceStats>  

Elemen isi respons dijelaskan dalam tabel berikut:

Header respons Deskripsi
Status Status lokasi sekunder. Potensi nilai:

- live: Menunjukkan bahwa lokasi sekunder aktif dan beroperasi.
- bootstrap: Menunjukkan bahwa sinkronisasi awal dari lokasi utama ke lokasi sekunder sedang berlangsung. Ini biasanya terjadi ketika replikasi pertama kali diaktifkan.
- tidak tersedia: Menunjukkan bahwa lokasi sekunder sementara tidak tersedia.
LastSyncTime Nilai tanggal/waktu GMT, ke nilai kedua. Semua penulisan utama yang mendahului nilai ini dijamin tersedia untuk operasi baca di sekunder. Penulisan utama setelah titik waktu ini mungkin atau mungkin tidak tersedia untuk dibaca.

Nilai mungkin kosong jika LastSyncTime tidak tersedia. Ini dapat terjadi jika status replikasi adalah bootstrap atau unavailable.

Meskipun replikasi geografis terus diaktifkan, hasilnya LastSyncTime mungkin mencerminkan nilai cache dari layanan, yang di-refresh setiap beberapa menit.

Authorization

Otorisasi diperlukan saat memanggil operasi akses data apa pun di Azure Storage. Anda dapat mengotorisasi operasi seperti yang Get Blob Service Stats dijelaskan di bawah ini.

Azure Storage mendukung penggunaan Microsoft Entra ID untuk mengotorisasi permintaan ke data blob. Dengan Microsoft Entra ID, Anda dapat menggunakan kontrol akses berbasis peran Azure (Azure RBAC) untuk memberikan izin kepada prinsip keamanan. Prinsip keamanan dapat berupa pengguna, grup, perwakilan layanan aplikasi, atau identitas terkelola Azure. Prinsip keamanan diautentikasi oleh Microsoft Entra ID untuk mengembalikan token OAuth 2.0. Token kemudian dapat digunakan untuk mengotorisasi permintaan terhadap Blob service.

Untuk mempelajari selengkapnya tentang otorisasi menggunakan Microsoft Entra ID, lihat Mengotorisasi akses ke blob menggunakan Microsoft Entra ID.

Izin

Tercantum di bawah ini adalah tindakan RBAC yang diperlukan bagi pengguna, grup, atau perwakilan layanan Microsoft Entra untuk memanggil Get Blob Service Stats operasi, dan peran Azure RBAC bawaan paling tidak istimewa yang mencakup tindakan ini:

Untuk mempelajari selengkapnya tentang menetapkan peran menggunakan Azure RBAC, lihat Menetapkan peran Azure untuk akses ke data blob.

Keterangan

Dengan replikasi geo-redundan, Azure Storage mempertahankan data Anda dengan tahan lama di dua lokasi yang terpisah ratusan mil. Di kedua lokasi, Azure Storage terus mempertahankan beberapa replika data Anda yang sehat.

Pasangan geo-redundan meliputi:

  • Lokasi Utama: Lokasi tempat Anda membaca, membuat, memperbarui, atau menghapus data. Lokasi utama ada di wilayah yang Anda pilih saat membuat akun melalui portal klasik Azure (misalnya, US Tengah Utara).

  • Lokasi Sekunder : Lokasi tempat data Anda direplikasi. Lokasi sekunder berada di wilayah yang secara geografis dipasangkan secara geografis dengan wilayah utama. Akses baca-saja tersedia dari lokasi sekunder jika replikasi geo-redundan akses baca diaktifkan untuk akun penyimpanan Anda. Untuk informasi selengkapnya tentang replikasi geo-redundan akses baca, lihat Redundansi data.

Lokasi tempat Anda membaca, membuat, memperbarui, atau menghapus data adalah lokasi akun penyimpanan utama . Lokasi utama ada di wilayah yang Anda pilih pada saat Anda membuat akun melalui portal klasik Azure Management Azure, misalnya, US Tengah Utara. Lokasi tempat data Anda direplikasi adalah lokasi sekunder . Lokasi sekunder berada di wilayah yang secara geografis dipasangkan secara geografis dengan wilayah utama. Akses baca-saja tersedia dari lokasi sekunder, jika replikasi geo-redundan akses baca diaktifkan untuk akun penyimpanan Anda. Untuk detail selengkapnya tentang replikasi geo-redundan akses baca, lihat Redundansi data.

Untuk membuat permintaan operasi baca terhadap titik akhir sekunder, tambahkan -secondary ke nama akun di URI yang Anda gunakan untuk membaca dari Blob Storage. Misalnya, URI sekunder untuk operasi Dapatkan Blob akan mirip https://myaccount-secondary.blob.core.windows.net/mycontainer/myblobdengan .

Billing

Permintaan harga dapat berasal dari klien yang menggunakan API Blob Storage, baik langsung melalui Blob Storage REST API, atau dari pustaka klien Azure Storage. Permintaan ini mengumpulkan biaya per transaksi. Jenis transaksi memengaruhi cara akun ditagih. Misalnya, transaksi baca bertambah ke kategori penagihan yang berbeda dari transaksi tulis. Tabel berikut ini memperlihatkan kategori penagihan untuk Get Blob Service Stats permintaan berdasarkan jenis akun penyimpanan:

Operasi Jenis akun penyimpanan Kategori penagihan
Dapatkan Statistik Blob Service Objek besar biner blok premium
Tujuan umum standar v2
Operasi lainnya
Dapatkan Statistik Blob Service Tujuan umum standar v1 Membacakan operasi

Untuk mempelajari tentang harga untuk kategori penagihan yang ditentukan, lihat harga Azure Blob Storage.

Sampel permintaan dan respons

Berikut adalah contoh permintaan untuk operasi:Get Blob Service Stats

GET http://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1  

Permintaan dikirim dengan header berikut:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT  
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=  

Kode status dan header respons dikembalikan sebagai berikut:

HTTP/1.1 200 OK  
Content-Type: application/xml  
Date: Wed, 23 Oct 2013 22:08:54 GMT  
x-ms-version: 2013-08-15  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  

Respons mencakup isi XML berikut:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>  
      <Status>live</Status>  
      <LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>        
  </GeoReplication>  
</StorageServiceStats>  

Lihat juga

Operasi pada akun (Blob Storage)