Dapatkan Informasi Akun
Operasi Get Account Information mengembalikan nama SKU dan jenis akun untuk akun yang ditentukan. Ini tersedia pada versi 2018-03-28 dan versi layanan yang lebih baru.
Minta
Anda dapat membuat permintaan Get Account Information dengan menggunakan permintaan valid yang diotorisasi melalui otorisasi kunci bersama atau tanda tangan akses bersama (SAS).
Jika Anda menambahkan nilai restypeaccount dan nilai compproperties, permintaan akan menggunakan operasi Get Account Information. Tabel berikut ini memperlihatkan contoh:
| Metode | Meminta URI | Versi HTTP |
|---|---|---|
GET/HEAD |
https://myaccount.blob.core.windows.net/?restype=account&comp=properties |
HTTP/1.1 |
GET/HEAD |
https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken |
HTTP/1.1 |
GET/HEAD |
https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken |
HTTP/1.1 |
GET/HEAD |
https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken |
HTTP/1.1 |
Parameter URI
Anda dapat menentukan parameter tambahan berikut pada URI permintaan:
| Parameter | Deskripsi |
|---|---|
restype |
Diperlukan. Nilai parameter restype harus account. |
comp |
Diperlukan. Nilai parameter comp harus properties. |
Header permintaan
Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional:
| Header permintaan | Deskripsi |
|---|---|
Authorization |
Diperlukan. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
Date or x-ms-date |
Diperlukan. 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 operasi ini, versi harus 2018-03-28 atau yang lebih baru. Untuk informasi selengkapnya, lihat Penerapan Versi untuk layanan Azure Storage. |
x-ms-client-request-id |
Fakultatif. 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. |
Isi permintaan
Tidak.
Jawaban
Respons mencakup kode status HTTP dan sekumpulan header respons.
Kode status
Operasi yang berhasil mengembalikan kode status 200 (OK).
Untuk informasi tentang kode status, lihat Status dan kode kesalahan.
Header respons
Respons untuk operasi ini mencakup header berikut. Respons mungkin juga menyertakan header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1 .
| Header respons | Deskripsi |
|---|---|
x-ms-request-id |
Mengidentifikasi permintaan yang dibuat secara unik. Anda dapat menggunakannya untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan masalah operasi API. |
x-ms-version |
Versi 2009-09-19 dan yang lebih baru. Menunjukkan versi Azure Blob Storage yang digunakan untuk menjalankan permintaan. |
Date |
Nilai tanggal/waktu UTC yang menunjukkan waktu layanan mengirim respons. |
Content-Length |
Menentukan panjang isi permintaan. Untuk operasi ini, panjang konten akan selalu nol. |
x-ms-sku-name |
Mengidentifikasi nama SKU akun yang ditentukan. |
x-ms-account-kind |
Mengidentifikasi jenis akun Storage, BlobStorage, dan StorageV2. Header membedakan antara akun penyimpanan General Purpose v1 (GPv1) dan General Purpose v2 (GPv2) dengan menggunakan substring V2 untuk akun GPv2. |
x-ms-client-request-id |
Dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai header x-ms-client-request-id, jika ada dalam permintaan dan nilainya paling banyak 1.024 karakter ASCII yang terlihat. Jika header x-ms-client-request-id tidak ada dalam permintaan, header ini tidak akan ada dalam respons. |
x-ms-is-hns-enabled |
Versi 2019-07-07 dan yang lebih baru. Menunjukkan apakah akun mengaktifkan namespace hierarkis. |
Isi respons
Tidak.
Sampel respons
Response Status:
HTTP/1.1 200 OK
Response Headers:
Date: Sat, 28 Mar 2018 12:43:08 GMT
x-ms-version: 2018-03-28
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
Content-Length: 0
x-ms-sku-name: Standard_LRS
x-ms-account-kind: StorageV2
Otorisasi
Otorisasi diperlukan saat memanggil operasi akses data apa pun di Azure Storage. Anda dapat mengotorisasi operasi Get Account Information seperti yang dijelaskan di bawah ini.
Penting
Microsoft merekomendasikan penggunaan ID Microsoft Entra dengan identitas terkelola untuk mengotorisasi permintaan ke Azure Storage. MICROSOFT Entra ID menyediakan keamanan yang unggul dan kemudahan penggunaan dibandingkan dengan otorisasi Kunci Bersama.
Azure Storage mendukung penggunaan ID Microsoft Entra 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 mungkin 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 layanan Blob.
Untuk mempelajari selengkapnya tentang otorisasi menggunakan ID Microsoft Entra, lihat Mengotorisasi akses ke blob menggunakan ID Microsoft Entra.
Izin
Tercantum di bawah ini adalah tindakan RBAC yang diperlukan untuk pengguna, grup, identitas terkelola, atau perwakilan layanan Microsoft Entra untuk memanggil operasi Get Account Information:
- tindakan Azure RBAC:Microsoft.Storage/storageAccounts/blobServices/getInfo/action
Tindakan RBAC ini disertakan dalam peran Pemilik, atau Anda dapat menetapkan tindakan ini ke peran kustom.
Untuk mempelajari selengkapnya tentang menetapkan peran menggunakan Azure RBAC, lihat Menetapkan peran Azure untuk akses ke data blob.
Komentar
Jalur URL permintaan tidak memengaruhi informasi yang diberikan operasi ini. Tujuannya adalah untuk memungkinkan permintaan untuk mengotorisasi dengan benar dengan token SAS yang menentukan sumber daya yang diizinkan.
Sumber daya yang ditentukan tidak perlu ada agar operasi ini berhasil. Misalnya, token SAS yang dihasilkan dengan blob yang tidak ada dan izin yang valid akan berhasil dengan jalur URL yang menyertakan nama akun yang benar, nama kontainer yang benar, dan nama blob yang tidak ada.
Penagihan
Permintaan harga dapat berasal dari klien yang menggunakan API Blob Storage, baik secara langsung melalui BLob Storage REST API, atau dari pustaka klien Azure Storage. Permintaan ini mengumpulkan biaya per transaksi. Jenis transaksi memengaruhi bagaimana akun ditagih. Misalnya, transaksi baca bertambah ke kategori penagihan yang berbeda dari transaksi tulis. Tabel berikut ini memperlihatkan kategori penagihan untuk permintaan Get Account Information berdasarkan jenis akun penyimpanan:
| Operasi | Jenis akun penyimpanan | Kategori penagihan |
|---|---|---|
| Dapatkan Informasi Akun | Blob blok premium Tujuan umum standar v2 |
Operasi lain |
| Dapatkan Informasi Akun | Tujuan umum standar v1 | Membaca operasi |
Untuk mempelajari tentang harga untuk kategori penagihan yang ditentukan, lihat Harga Azure Blob Storage.