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:
- Tindakan Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/read
- Peran bawaan dengan hak istimewa paling sedikit:Kontributor Akun Penyimpanan
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/myblob
dengan .
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>