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 Get Account Information permintaan dengan menggunakan permintaan valid yang diotorisasi melalui kunci bersama atau otorisasi tanda tangan akses bersama (SAS).

Jika Anda menambahkan restype nilai account dan comp nilai properties, permintaan akan menggunakan Get Account Information operasi . 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	Wajib diisi. Nilai restype parameter harus account.
comp	Wajib diisi. Nilai comp parameter harus properties.

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 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	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.

Isi permintaan

Tidak ada.

Respons

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 Kode status dan 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	Secara unik mengidentifikasi permintaan yang dibuat. 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 dari akun yang ditentukan.
x-ms-account-kind	Mengidentifikasi jenis akun dari akun yang ditentukan. Nilai yang mungkin adalah 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 x-ms-client-request-id header, jika ada dalam permintaan dan nilainya paling banyak 1.024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header 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 ada.

Respons sampel

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  

Authorization

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

Operasi ini tidak mendukung otorisasi berbasis OAuth melalui token akses dari Azure Active Directory/MSI atau delegasi pengguna SAS.

Tanda tangan akses bersama (SAS)

Tanda tangan akses bersama (SAS) menyediakan akses yang didelegasikan dengan aman ke sumber daya di akun penyimpanan. Dengan SAS, Anda memiliki kontrol terperinci atas bagaimana klien dapat mengakses data. Anda dapat menentukan sumber daya apa yang dapat diakses klien, izin apa yang mereka miliki ke sumber daya tersebut, dan berapa lama SAS valid.

Operasi ini Get Account Information mendukung otorisasi menggunakan SAS akun atau LAYANAN SAS dengan setidaknya satu izin yang tersedia.

Akun SAS

Akun SAS diamankan dengan kunci akun penyimpanan. Akun SAS delegasikan akses ke sumber daya di satu atau beberapa layanan penyimpanan. Semua operasi yang tersedia melalui layanan atau delegasi pengguna SAS juga tersedia melalui akun SAS.

Untuk mempelajari selengkapnya tentang akun SAS, lihat Membuat AKUN SAS.

Layanan SAS

Layanan SAS diamankan dengan kunci akun penyimpanan. SAS layanan mendelegasikan akses ke sumber daya dalam satu layanan Azure Storage, seperti penyimpanan blob.

Ketika akses Kunci Bersama tidak diizinkan untuk akun penyimpanan, token SAS layanan tidak akan diizinkan berdasarkan permintaan ke Blob Storage. Untuk mempelajari selengkapnya, lihat Memahami bagaimana melarang Kunci Bersama memengaruhi token SAS.

Untuk mempelajari selengkapnya tentang layanan SAS, lihat Membuat LAYANAN SAS.

Kunci Bersama

Operasi ini Get Account Information mendukung otorisasi Kunci Bersama. Otorisasi dengan kunci akun tidak disarankan untuk sebagian besar skenario, karena kurang aman. Microsoft merekomendasikan untuk melarang otorisasi Kunci Bersama untuk akun penyimpanan jika memungkinkan. Untuk informasi selengkapnya, lihat Mencegah otorisasi dengan Kunci Bersama.

Keterangan

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.

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 Account Information permintaan berdasarkan jenis akun penyimpanan:

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

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