Blob Containers - Update

Memperbarui properti kontainer seperti yang ditentukan dalam isi permintaan. Properti yang tidak disebutkan dalam permintaan tidak akan berubah. Pembaruan gagal jika kontainer yang ditentukan belum ada.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default/containers/{containerName}?api-version=2021-09-01

Parameter URI

Name In Required Type Description
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.

containerName
path True
  • string

Nama kontainer blob dalam akun penyimpanan yang ditentukan. Panjang nama kontainer blob 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.

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.

Isi Permintaan

Name Type Description
properties.defaultEncryptionScope
  • string

Default kontainer untuk menggunakan cakupan enkripsi tertentu untuk semua penulisan.

properties.denyEncryptionScopeOverride
  • boolean

Penimpaan blok cakupan enkripsi dari default kontainer.

properties.enableNfsV3AllSquash
  • boolean

Aktifkan NFSv3 semua squash pada kontainer blob.

properties.enableNfsV3RootSquash
  • boolean

Aktifkan root squash NFSv3 pada kontainer blob.

properties.immutableStorageWithVersioning

Properti imutabilitas tingkat objek dari kontainer. Properti tidak dapat diubah dan hanya dapat diatur ke true pada waktu pembuatan kontainer. Kontainer yang ada harus menjalani proses migrasi.

properties.metadata
  • object

Pasangan nama-nilai untuk dikaitkan dengan kontainer sebagai metadata.

properties.publicAccess

Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.

Respons

Name Type Description
200 OK

OK -- Operasi Perbarui Kontainer berhasil diselesaikan.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation meniru akun pengguna Anda

Contoh

UpdateContainers

Sample Request

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185?api-version=2021-09-01

{
  "properties": {
    "publicAccess": "Container",
    "metadata": {
      "metadata": "true"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185",
  "name": "container6185",
  "type": "Microsoft.Storage/storageAccounts/blobServices/containers",
  "properties": {
    "metadata": {
      "metadata": "true"
    },
    "publicAccess": "Container",
    "hasImmutabilityPolicy": false,
    "hasLegalHold": false
  }
}

Definisi

BlobContainer

Properti kontainer blob, termasuk Id, nama sumber daya, jenis sumber daya, Etag.

ImmutabilityPolicyProperties

Properti ImmutabilityPolicy dari kontainer blob.

ImmutabilityPolicyState

Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.

ImmutabilityPolicyUpdateType

Jenis pembaruan ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: put, lock, dan extend.

ImmutableStorageWithVersioning

Properti imutabilitas tingkat objek kontainer.

LeaseDuration

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

LeaseState

Status sewa kontainer.

LeaseStatus

Status sewa kontainer.

LegalHoldProperties

Properti LegalHold dari kontainer blob.

MigrationState

Properti ini menunjukkan tingkat kekekalan kontainer terhadap status migrasi kekekalan tingkat objek.

ProtectedAppendWritesHistory

Penampan terlindungi menulis pengaturan riwayat untuk kontainer blob dengan Penahanan legal.

PublicAccess

Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.

TagProperty

Tag LegalHold dari kontainer blob.

UpdateHistoryProperty

Riwayat pembaruan ImmutabilityPolicy dari kontainer blob.

BlobContainer

Properti kontainer blob, termasuk Id, nama sumber daya, jenis sumber daya, Etag.

Name Type Description
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.defaultEncryptionScope
  • string

Default kontainer untuk menggunakan cakupan enkripsi tertentu untuk semua penulisan.

properties.deleted
  • boolean

Menunjukkan apakah kontainer blob dihapus.

properties.deletedTime
  • string

Waktu penghapusan kontainer blob.

properties.denyEncryptionScopeOverride
  • boolean

Penimpaan blok cakupan enkripsi dari default kontainer.

properties.enableNfsV3AllSquash
  • boolean

Aktifkan NFSv3 semua squash pada kontainer blob.

properties.enableNfsV3RootSquash
  • boolean

Aktifkan root squash NFSv3 pada kontainer blob.

properties.hasImmutabilityPolicy
  • boolean

Properti publik hasImmutabilityPolicy diatur ke true oleh SRP jika ImmutabilityPolicy telah dibuat untuk kontainer ini. Properti publik hasImmutabilityPolicy diatur ke false oleh SRP jika ImmutabilityPolicy belum dibuat untuk kontainer ini.

properties.hasLegalHold
  • boolean

Properti publik hasLegalHold diatur ke true oleh SRP jika setidaknya ada satu tag yang ada. Properti publik hasLegalHold diatur ke false oleh SRP jika semua tag penahanan legal yang ada dibersihkan. Mungkin ada maksimal 1000 kontainer blob dengan hasLegalHold=true untuk akun tertentu.

properties.immutabilityPolicy

Properti ImmutabilityPolicy dari kontainer.

properties.immutableStorageWithVersioning

Properti imutabilitas tingkat objek dari kontainer. Properti tidak dapat diubah dan hanya dapat diatur ke true pada waktu pembuatan kontainer. Kontainer yang ada harus menjalani proses migrasi.

properties.lastModifiedTime
  • string

Mengembalikan tanggal dan waktu kontainer terakhir diubah.

properties.leaseDuration

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

properties.leaseState

Status sewa kontainer.

properties.leaseStatus

Status sewa kontainer.

properties.legalHold

Properti LegalHold dari kontainer.

properties.metadata
  • object

Pasangan nama-nilai untuk dikaitkan dengan kontainer sebagai metadata.

properties.publicAccess

Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.

properties.remainingRetentionDays
  • integer

Sisa hari retensi untuk kontainer blob yang dihapus sementara.

properties.version
  • string

Versi kontainer blob yang dihapus.

type
  • string

Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft. Storage/storageAccounts"

ImmutabilityPolicyProperties

Properti ImmutabilityPolicy dari kontainer blob.

Name Type Description
etag
  • string

ImmutabilityPolicy Etag.

properties.allowProtectedAppendWrites
  • boolean

Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke blob penambahan sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API.

properties.allowProtectedAppendWritesAll
  • boolean

Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke 'Tambahkan dan Bock Blob' sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API. Properti 'allowProtectedAppendWrites' dan 'allowProtectedAppendWritesAll' saling eksklusif.

properties.immutabilityPeriodSinceCreationInDays
  • integer

Periode imutabilitas untuk blob dalam kontainer sejak pembuatan kebijakan, dalam beberapa hari.

properties.state

Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.

updateHistory

Riwayat pembaruan ImmutabilityPolicy dari kontainer blob.

ImmutabilityPolicyState

Status ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: Terkunci dan Tidak Terkunci.

Name Type Description
Locked
  • string
Unlocked
  • string

ImmutabilityPolicyUpdateType

Jenis pembaruan ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: put, lock, dan extend.

Name Type Description
extend
  • string
lock
  • string
put
  • string

ImmutableStorageWithVersioning

Properti imutabilitas tingkat objek kontainer.

Name Type Description
enabled
  • boolean

Ini adalah properti yang tidak dapat diubah, ketika diatur ke true, ini memungkinkan kekekalan tingkat objek pada tingkat kontainer.

migrationState

Properti ini menunjukkan tingkat kekekalan kontainer terhadap status migrasi kekekalan tingkat objek.

timeStamp
  • string

Mengembalikan tanggal dan waktu kekekalan tingkat objek diaktifkan.

LeaseDuration

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

Name Type Description
Fixed
  • string
Infinite
  • string

LeaseState

Status sewa kontainer.

Name Type Description
Available
  • string
Breaking
  • string
Broken
  • string
Expired
  • string
Leased
  • string

LeaseStatus

Status sewa kontainer.

Name Type Description
Locked
  • string
Unlocked
  • string

LegalHoldProperties

Properti LegalHold dari kontainer blob.

Name Type Description
hasLegalHold
  • boolean

Properti publik hasLegalHold diatur ke true oleh SRP jika setidaknya ada satu tag yang ada. Properti publik hasLegalHold diatur ke false oleh SRP jika semua tag penahanan legal yang ada dibersihkan. Mungkin ada maksimal 1000 kontainer blob dengan hasLegalHold=true untuk akun tertentu.

protectedAppendWritesHistory

Riwayat penulisan blob tambahan yang dilindungi.

tags

Daftar tag LegalHold dari kontainer blob.

MigrationState

Properti ini menunjukkan tingkat kekekalan kontainer terhadap status migrasi kekekalan tingkat objek.

Name Type Description
Completed
  • string
InProgress
  • string

ProtectedAppendWritesHistory

Penampan terlindungi menulis pengaturan riwayat untuk kontainer blob dengan Penahanan legal.

Name Type Description
allowProtectedAppendWritesAll
  • boolean

Saat diaktifkan, blok baru dapat ditulis ke 'Tambahkan dan Bock Blob' sambil mempertahankan perlindungan dan kepatuhan penahanan hukum. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus.

timestamp
  • string

Mengembalikan tanggal dan waktu tag ditambahkan.

PublicAccess

Menentukan apakah data dalam kontainer dapat diakses secara publik dan tingkat akses.

Name Type Description
Blob
  • string
Container
  • string
None
  • string

TagProperty

Tag LegalHold dari kontainer blob.

Name Type Description
objectIdentifier
  • string

Mengembalikan ID Objek pengguna yang menambahkan tag.

tag
  • string

Nilai tag.

tenantId
  • string

Mengembalikan ID Penyewa yang mengeluarkan token untuk pengguna yang menambahkan tag.

timestamp
  • string

Mengembalikan tanggal dan waktu tag ditambahkan.

upn
  • string

Mengembalikan Nama Prinsipal Pengguna pengguna yang menambahkan tag.

UpdateHistoryProperty

Riwayat pembaruan ImmutabilityPolicy dari kontainer blob.

Name Type Description
allowProtectedAppendWrites
  • boolean

Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke blob penambahan sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API.

allowProtectedAppendWritesAll
  • boolean

Properti ini hanya dapat diubah untuk kebijakan penyimpanan berbasis waktu yang tidak terkunci. Saat diaktifkan, blok baru dapat ditulis ke 'Tambahkan dan Bock Blob' sambil mempertahankan perlindungan dan kepatuhan imutabilitas. Hanya blok baru yang dapat ditambahkan dan blok yang ada tidak dapat dimodifikasi atau dihapus. Properti ini tidak dapat diubah dengan ExtendImmutabilityPolicy API. Properti 'allowProtectedAppendWrites' dan 'allowProtectedAppendWritesAll' saling eksklusif.

immutabilityPeriodSinceCreationInDays
  • integer

Periode imutabilitas untuk blob dalam kontainer sejak pembuatan kebijakan, dalam beberapa hari.

objectIdentifier
  • string

Mengembalikan ID Objek pengguna yang memperbarui ImmutabilityPolicy.

tenantId
  • string

Mengembalikan ID Penyewa yang mengeluarkan token untuk pengguna yang memperbarui ImmutabilityPolicy.

timestamp
  • string

Mengembalikan tanggal dan waktu ImmutabilityPolicy diperbarui.

update

Jenis pembaruan ImmutabilityPolicy dari kontainer blob, nilai yang mungkin meliputi: put, lock, dan extend.

upn
  • string

Mengembalikan Nama Prinsipal Pengguna pengguna yang memperbarui ImmutabilityPolicy.