File Shares - Get
Mendapatkan properti dari berbagi tertentu.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01&$expand={$expand}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
account
|
path | True |
string |
Nama akun penyimpanan dalam grup sumber daya yang ditentukan. Nama akun penyimpanan harus sepanjang antara 3 dan 24 karakter dan hanya menggunakan angka dan huruf kecil. Regex pattern: |
resource
|
path | True |
string |
Nama grup sumber daya dalam langganan pengguna. Nama tidak peka huruf besar/kecil. Regex pattern: |
share
|
path | True |
string |
Nama berbagi file dalam akun penyimpanan yang ditentukan. Panjang nama berbagi file harus antara 3 dan 63 karakter dan menggunakan angka, huruf kecil dan tanda hubung (-) saja. Setiap karakter tanda hubung (-) harus segera didahului dan diikuti dengan huruf atau angka. |
subscription
|
path | True |
string |
ID langganan target. |
api-version
|
query | True |
string |
Versi API yang digunakan untuk operasi ini. |
$expand
|
query |
string |
Opsional, digunakan untuk memperluas properti dalam properti berbagi. Nilai yang valid adalah: statistik. Harus diteruskan sebagai string dengan pemisah ','. |
Header Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
x-ms-snapshot |
string |
Opsional, digunakan untuk mengambil properti rekam jepret. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK -- Operasi Dapatkan Berbagi berhasil diselesaikan. |
|
Other Status Codes |
Respons kesalahan yang menjelaskan mengapa operasi gagal. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
Get |
Get |
GetShares
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634?api-version=2023-01-01
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634",
"name": "share1634",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"etag": "\"0x8D592D74CC20EBA\"",
"properties": {
"lastModifiedTime": "2019-05-26T05:06:14Z",
"shareQuota": 1024
}
}
GetShareStats
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634?api-version=2023-01-01&$expand=stats
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634",
"name": "share1634",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"etag": "\"0x8D592D74CC20EBA\"",
"properties": {
"lastModifiedTime": "2019-05-26T05:06:14Z",
"shareQuota": 1024,
"shareUsageBytes": 652945
}
}
Definisi
Nama | Deskripsi |
---|---|
Access |
|
Cloud |
Respons kesalahan dari layanan Penyimpanan. |
Cloud |
Respons kesalahan dari layanan Penyimpanan. |
Enabled |
Protokol autentikasi yang digunakan untuk berbagi file. Hanya dapat ditentukan saat membuat berbagi. |
File |
Properti berbagi file, termasuk Id, nama sumber daya, jenis sumber daya, Etag. |
Lease |
Menentukan apakah sewa pada berbagi memiliki durasi tak terbatas atau tetap, hanya ketika berbagi disewakan. |
Lease |
Status sewa berbagi. |
Lease |
Status sewa berbagi. |
Root |
Properti hanya untuk berbagi NFS. Defaultnya adalah NoRootSquash. |
Share |
Tingkat akses untuk berbagi tertentu. Akun GpV2 dapat memilih antara TransactionOptimized (default), Hot, dan Cool. Akun FileStorage dapat memilih Premium. |
Signed |
AccessPolicy
Nama | Jenis | Deskripsi |
---|---|---|
expiryTime |
string |
Waktu kedaluwarsa kebijakan akses |
permission |
string |
Daftar izin yang disingkat. |
startTime |
string |
Waktu mulai kebijakan akses |
CloudError
Respons kesalahan dari layanan Penyimpanan.
Nama | Jenis | Deskripsi |
---|---|---|
error |
Respons kesalahan dari layanan Penyimpanan. |
CloudErrorBody
Respons kesalahan dari layanan Penyimpanan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Pengidentifikasi untuk kesalahan. Kode tidak berubah dan dimaksudkan untuk dikonsumsi secara terprogram. |
details |
Daftar detail tambahan tentang kesalahan. |
|
message |
string |
Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna. |
target |
string |
Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan. |
EnabledProtocols
Protokol autentikasi yang digunakan untuk berbagi file. Hanya dapat ditentukan saat membuat berbagi.
Nama | Jenis | Deskripsi |
---|---|---|
NFS |
string |
|
SMB |
string |
FileShare
Properti berbagi file, termasuk Id, nama sumber daya, jenis sumber daya, Etag.
Nama | Jenis | Deskripsi |
---|---|---|
etag |
string |
Sumber Daya Etag. |
id |
string |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nama sumber daya. |
properties.accessTier |
Tingkat akses untuk berbagi tertentu. Akun GpV2 dapat memilih antara TransactionOptimized (default), Hot, dan Cool. Akun FileStorage dapat memilih Premium. |
|
properties.accessTierChangeTime |
string |
Menunjukkan waktu modifikasi terakhir untuk tingkat akses berbagi. |
properties.accessTierStatus |
string |
Menunjukkan apakah ada transisi yang tertunda untuk tingkat akses. |
properties.deleted |
boolean |
Menunjukkan apakah berbagi telah dihapus. |
properties.deletedTime |
string |
Waktu yang dihapus jika berbagi dihapus. |
properties.enabledProtocols |
Protokol autentikasi yang digunakan untuk berbagi file. Hanya dapat ditentukan saat membuat berbagi. |
|
properties.lastModifiedTime |
string |
Mengembalikan tanggal dan waktu berbagi terakhir diubah. |
properties.leaseDuration |
Menentukan apakah sewa pada berbagi memiliki durasi tak terbatas atau tetap, hanya ketika berbagi disewakan. |
|
properties.leaseState |
Status sewa berbagi. |
|
properties.leaseStatus |
Status sewa berbagi. |
|
properties.metadata |
object |
Pasangan nama-nilai untuk dikaitkan dengan berbagi sebagai metadata. |
properties.remainingRetentionDays |
integer |
Sisa hari retensi untuk berbagi yang dihapus sementara. |
properties.rootSquash |
Properti hanya untuk berbagi NFS. Defaultnya adalah NoRootSquash. |
|
properties.shareQuota |
integer |
Ukuran maksimum berbagi, dalam gigabyte. Harus lebih besar dari 0, dan kurang dari atau sama dengan 5TB (5120). Untuk Berbagi File Besar, ukuran maksimumnya adalah 102400. |
properties.shareUsageBytes |
integer |
Perkiraan ukuran data yang disimpan pada berbagi. Perhatikan bahwa nilai ini mungkin tidak menyertakan semua file yang baru dibuat atau baru-baru ini diubah ukurannya. |
properties.signedIdentifiers |
Daftar kebijakan akses tersimpan yang ditentukan pada berbagi. |
|
properties.snapshotTime |
string |
Waktu pembuatan rekam jepret berbagi dikembalikan dalam respons pembagian daftar dengan "rekam jepret" param yang diperluas. |
properties.version |
string |
Versi berbagi. |
type |
string |
Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
LeaseDuration
Menentukan apakah sewa pada berbagi memiliki durasi tak terbatas atau tetap, hanya ketika berbagi disewakan.
Nama | Jenis | Deskripsi |
---|---|---|
Fixed |
string |
|
Infinite |
string |
LeaseState
Status sewa berbagi.
Nama | Jenis | Deskripsi |
---|---|---|
Available |
string |
|
Breaking |
string |
|
Broken |
string |
|
Expired |
string |
|
Leased |
string |
LeaseStatus
Status sewa berbagi.
Nama | Jenis | Deskripsi |
---|---|---|
Locked |
string |
|
Unlocked |
string |
RootSquashType
Properti hanya untuk berbagi NFS. Defaultnya adalah NoRootSquash.
Nama | Jenis | Deskripsi |
---|---|---|
AllSquash |
string |
|
NoRootSquash |
string |
|
RootSquash |
string |
ShareAccessTier
Tingkat akses untuk berbagi tertentu. Akun GpV2 dapat memilih antara TransactionOptimized (default), Hot, dan Cool. Akun FileStorage dapat memilih Premium.
Nama | Jenis | Deskripsi |
---|---|---|
Cool |
string |
|
Hot |
string |
|
Premium |
string |
|
TransactionOptimized |
string |
SignedIdentifier
Nama | Jenis | Deskripsi |
---|---|---|
accessPolicy |
Kebijakan akses |
|
id |
string |
Pengidentifikasi unik dari kebijakan akses tersimpan. |