File Shares - Update

Updates berbagi properti seperti yang ditentukan dalam isi permintaan. Properti yang tidak disebutkan dalam permintaan tidak akan diubah. Pembaruan gagal jika berbagi yang ditentukan belum ada.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01

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\._\(\)]+$

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

subscriptionId
path True

string

ID langganan target.

api-version
query True

string

Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama Jenis Deskripsi
properties.accessTier

ShareAccessTier

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

properties.enabledProtocols

EnabledProtocols

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

properties.metadata

object

Pasangan nama-nilai untuk dikaitkan dengan berbagi sebagai metadata.

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

SignedIdentifier[]

Daftar kebijakan akses tersimpan yang ditentukan pada berbagi.

Respons

Nama Jenis Deskripsi
200 OK

FileShare

OK -- Operasi Perbarui 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

UpdateShareAcls
UpdateShares

UpdateShareAcls

Sample Request

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01

{
  "properties": {
    "signedIdentifiers": [
      {
        "id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
        "accessPolicy": {
          "startTime": "2021-04-01T08:49:37.0000000Z",
          "expiryTime": "2021-05-01T08:49:37.0000000Z",
          "permission": "rwd"
        }
      }
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "signedIdentifiers": [
      {
        "id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
        "accessPolicy": {
          "startTime": "2021-04-01T08:49:37.0000000Z",
          "expiryTime": "2021-05-01T08:49:37.0000000Z",
          "permission": "rwd"
        }
      }
    ]
  }
}

UpdateShares

Sample Request

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01

{
  "properties": {
    "metadata": {
      "type": "image"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "metadata": {
      "type": "image"
    }
  }
}

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.

FileShare

Properti berbagi file, termasuk Id, nama sumber daya, jenis sumber daya, Etag.

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.

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

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

properties.signedIdentifiers

SignedIdentifier[]

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

AccessPolicy

Kebijakan akses

id

string

Pengidentifikasi unik dari kebijakan akses tersimpan.