File Shares - List

Lists semua berbagi.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares?api-version=2023-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares?api-version=2023-01-01&$maxpagesize={$maxpagesize}&$filter={$filter}&$expand={$expand}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
accountName
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: ^[a-z0-9]+$

resourceGroupName
path True

string

Nama grup sumber daya dalam langganan pengguna. Nama tidak peka huruf besar/kecil.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
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: dihapus, rekam jepret. Harus diteruskan sebagai string dengan pemisah ','

$filter
query

string

Pilihan. Ketika ditentukan, hanya nama berbagi yang dimulai dengan filter yang akan dicantumkan.

$maxpagesize
query

string

Pilihan. Jumlah maksimum berbagi yang ditentukan yang dapat disertakan dalam daftar.

Respons

Nama Jenis Deskripsi
200 OK

FileShareItems

OK -- Operasi Daftar Berbagi berhasil diselesaikan.

Other Status Codes

CloudError

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

ListDeletedShares
ListShares
ListShareSnapshots

ListDeletedShares

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-01-01&$expand=deleted

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share1644_1234567890",
      "name": "share1644",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847D51C7DE\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024,
        "version": "1234567890",
        "deleted": true,
        "deletedTime": "2019-12-14T08:20:47Z",
        "remainingRetentionDays": 30
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    }
  ]
}

ListShares

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-01-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share1644",
      "name": "share1644",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847D51C7DE\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    }
  ],
  "nextLink": "https://sto1590endpoint/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2022-09-01&$maxpagesize=2&$skipToken=/sto1590/share5103"
}

ListShareSnapshots

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-01-01&$expand=snapshots

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2020-10-26T05:47:05.0000000Z",
        "shareQuota": 1024
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2020-10-26T05:47:05.0000000Z",
        "shareQuota": 1024,
        "snapshotTime": "2020-10-26T05:48:07.0000000Z"
      }
    }
  ]
}

Definisi

Nama Deskripsi
AccessPolicy
CloudError

Respons kesalahan dari layanan Penyimpanan.

CloudErrorBody

Respons kesalahan dari layanan Penyimpanan.

EnabledProtocols

Protokol autentikasi yang digunakan untuk berbagi file. Hanya dapat ditentukan saat membuat berbagi.

FileShareItem

Properti berbagi file akan dicantumkan.

FileShareItems

Skema respons. Berisi daftar berbagi yang dikembalikan, dan jika halaman diminta atau diperlukan, URL ke halaman berbagi berikutnya.

LeaseDuration

Menentukan apakah sewa pada berbagi memiliki durasi tak terbatas atau tetap, hanya ketika berbagi disewakan.

LeaseState

Status sewa berbagi.

LeaseStatus

Status sewa berbagi.

RootSquashType

Properti hanya untuk berbagi NFS. Defaultnya adalah NoRootSquash.

ShareAccessTier

Tingkat akses untuk berbagi tertentu. Akun GpV2 dapat memilih antara TransactionOptimized (default), Hot, dan Cool. Akun FileStorage dapat memilih Premium.

SignedIdentifier

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

CloudErrorBody

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

CloudErrorBody[]

Daftar detail tambahan tentang kesalahan tersebut.

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

FileShareItem

Properti berbagi file akan dicantumkan.

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

ShareAccessTier

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

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

LeaseDuration

Menentukan apakah sewa pada berbagi memiliki durasi tak terbatas atau tetap, hanya ketika berbagi disewakan.

properties.leaseState

LeaseState

Status sewa berbagi.

properties.leaseStatus

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

RootSquashType

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 di berbagi. Perhatikan bahwa nilai ini mungkin tidak menyertakan semua file yang baru dibuat atau yang baru diubah ukurannya.

properties.signedIdentifiers

SignedIdentifier[]

Daftar kebijakan akses tersimpan yang ditentukan pada berbagi.

properties.snapshotTime

string

Waktu pembuatan rekam jepret berbagi dikembalikan dalam respons berbagi 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"

FileShareItems

Skema respons. Berisi daftar berbagi yang dikembalikan, dan jika halaman diminta atau diperlukan, URL ke halaman berbagi berikutnya.

Nama Jenis Deskripsi
nextLink

string

URL Permintaan yang dapat digunakan untuk mengkueri halaman berbagi berikutnya. Dikembalikan ketika jumlah total berbagi yang diminta melebihi ukuran halaman maksimum.

value

FileShareItem[]

Daftar berbagi file yang dikembalikan.

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

AccessPolicy

Kebijakan akses

id

string

Pengidentifikasi unik dari kebijakan akses tersimpan.