Storage Appliances - Update
Memperbarui properti appliance penyimpanan yang disediakan, atau memperbarui tag yang terkait dengan Properti appliance penyimpanan dan pembaruan tag dapat dilakukan secara independen.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}?api-version=2025-09-01
Parameter URI
| Nama | Dalam | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
storage
|
path | True |
string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ |
Nama appliance penyimpanan. |
|
subscription
|
path | True |
string (uuid) |
ID langganan target. Nilainya harus sebuah UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
Header Permintaan
| Nama | Diperlukan | Jenis | Deskripsi |
|---|---|---|---|
| If-Match |
string |
ETag transformasi. Hilangkan nilai ini untuk selalu menimpa sumber daya saat ini. Tentukan nilai ETag yang terakhir dilihat untuk mencegah penimpaan perubahan bersamaan secara tidak sengaja. |
|
| If-None-Match |
string |
Atur ke '*' untuk mengizinkan kumpulan catatan baru dibuat, tetapi untuk mencegah pembaruan sumber daya yang ada. Nilai lain akan mengakibatkan kesalahan dari server karena tidak didukung. |
Isi Permintaan
| Nama | Jenis | Deskripsi |
|---|---|---|
| properties.serialNumber |
string |
Nomor seri untuk appliance penyimpanan. |
| tags |
object |
Tag sumber daya. |
Respons
| Nama | Jenis | Deskripsi |
|---|---|---|
| 200 OK |
Operasi Azure berhasil diselesaikan. |
|
| 202 Accepted |
Permintaan pembaruan sumber daya diterima. Header
|
|
| Other Status Codes |
Respons kesalahan tak terduga. |
Keamanan
azure_auth
Alur OAuth2 Azure Active Directory.
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
| Nama | Deskripsi |
|---|---|
| user_impersonation | meniru akun pengguna Anda |
Contoh
Patch storage appliance
Permintaan sampel
PATCH https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/storageAppliances/storageApplianceName?api-version=2025-09-01
{
"properties": {
"serialNumber": "BM1219XXX"
},
"tags": {
"key1": "myvalue1",
"key2": "myvalue2"
}
}
Respon sampel
{
"extendedLocation": {
"name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
"type": "CustomLocation"
},
"id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/storageAppliances/storageApplianceName",
"location": "location",
"name": "storageApplianceName",
"properties": {
"administratorCredentials": {
"username": "adminUser"
},
"caCertificate": {
"hash": "dea698309efd2830a1d440a807650d9aa6d954b3243ab8cb556ac98c1f3faa60",
"value": "-----BEGIN CERTIFICATE-----\nMIIDXTCCAkWgAwIBAgIJAL4a5b1d8f2wM...A0GCSqGSIb3DQEBCwUAMEUxCzAJB==\n-----END CERTIFICATE-----"
},
"capacity": 893,
"capacityUsed": 500,
"clusterId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName",
"detailedStatus": "Available",
"detailedStatusMessage": "Storage appliance is up and running",
"managementIpv4Address": "192.0.2.2",
"manufacturer": "Contoso Storage",
"model": "ArrayStore-Flash70",
"provisioningState": "Succeeded",
"rackId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/racks/rackName",
"rackSlot": 1,
"remoteVendorManagementFeature": "Supported",
"remoteVendorManagementStatus": "Enabled",
"secretRotationStatus": [
{
"expirePeriodDays": 90,
"lastRotationTime": "2023-09-30T13:27:23.103Z",
"rotationPeriodDays": 60,
"secretArchiveReference": {
"keyVaultId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.KeyVault/vaults/keyVaultName",
"secretName": "ffffffff-ffff-ffff-ffff-ffffffffffff-resource-group-cluster-1679871-storage-appliance-credential-manager-ffffffff",
"secretVersion": "02ab6c1f9c0f4982b0632b0d5d74a33b"
},
"secretType": "Storage Appliance User"
}
],
"serialNumber": "BM1219XXX",
"storageApplianceSkuId": "684E-3B16-399E",
"version": "9.9.9"
},
"systemData": {
"createdAt": "2021-01-22T13:27:03.008Z",
"createdBy": "identityA",
"createdByType": "Application",
"lastModifiedAt": "2021-01-22T13:29:03.001Z",
"lastModifiedBy": "identityB",
"lastModifiedByType": "User"
},
"tags": {
"key1": "myvalue1",
"key2": "myvalue2"
},
"type": "Microsoft.NetworkCloud/storageAppliances"
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2025-09-01
Location: https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/providers/Microsoft.NetworkCloud/locations/location/operationStatuses/operationId?api-version=2025-09-01
Definisi
| Nama | Deskripsi |
|---|---|
|
Administrative |
AdministrativeCredentials mewakili kredensial admin untuk perangkat yang memerlukan autentikasi berbasis kata sandi. |
|
Azure. |
Jenis kompleks lokasi yang diperluas. |
|
Certificate |
CertificateInfo mewakili informasi non-pribadi dari Sertifikat X.509. |
|
created |
Jenis identitas yang membuat sumber daya. |
|
Error |
Info tambahan kesalahan manajemen sumber daya. |
|
Error |
Detail kesalahan. |
|
Error |
Tanggapan kesalahan |
|
Extended |
Jenis lokasi yang diperluas. |
|
Remote |
Indikator apakah alat penyimpanan mendukung manajemen vendor jarak jauh. |
|
Remote |
Indikator apakah fitur manajemen vendor jarak jauh diaktifkan atau dinonaktifkan, atau tidak didukung jika fitur tersebut adalah fitur yang tidak didukung. |
|
Secret |
SecretArchiveReference mewakili referensi ke rahasia di brankas kunci. |
|
Secret |
SecretRotationStatus mewakili status rotasi rahasia. |
|
Storage |
StorageAppliance mewakili appliance penyimpanan Network Cloud lokal. |
|
Storage |
Status terperinci dari alat penyimpanan. |
|
Storage |
StorageAppliancePatchParameters mewakili isi permintaan untuk menambal properti appliance penyimpanan. |
|
Storage |
Status penyediaan alat penyimpanan. |
|
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
AdministrativeCredentials
AdministrativeCredentials mewakili kredensial admin untuk perangkat yang memerlukan autentikasi berbasis kata sandi.
| Nama | Jenis | Deskripsi |
|---|---|---|
| password |
string (password) minLength: 1 |
Kata sandi administrator perangkat yang digunakan selama inisialisasi. |
| username |
string minLength: 1 |
Nama pengguna administrator perangkat yang digunakan selama inisialisasi. |
Azure.ResourceManager.CommonTypes.ExtendedLocation
Jenis kompleks lokasi yang diperluas.
| Nama | Jenis | Deskripsi |
|---|---|---|
| name |
string |
Nama lokasi yang diperluas. |
| type |
Jenis lokasi yang diperluas. |
CertificateInfo
CertificateInfo mewakili informasi non-pribadi dari Sertifikat X.509.
| Nama | Jenis | Deskripsi |
|---|---|---|
| hash |
string |
Nilai hash Sertifikat X.509. |
| value |
string |
Nilai tekstual Sertifikat X.509. |
createdByType
Jenis identitas yang membuat sumber daya.
| Nilai | Deskripsi |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| info |
object |
Info tambahan. |
| type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| additionalInfo |
Info tambahan kesalahan. |
|
| code |
string |
Kode kesalahan. |
| details |
Detail kesalahan. |
|
| message |
string |
Pesan kesalahan. |
| target |
string |
Target kesalahan. |
ErrorResponse
Tanggapan kesalahan
| Nama | Jenis | Deskripsi |
|---|---|---|
| error |
Objek kesalahan. |
ExtendedLocationType
Jenis lokasi yang diperluas.
| Nilai | Deskripsi |
|---|---|
| EdgeZone |
Jenis lokasi Zona Azure Edge |
| CustomLocation |
Jenis Lokasi Kustom Azure |
RemoteVendorManagementFeature
Indikator apakah alat penyimpanan mendukung manajemen vendor jarak jauh.
| Nilai | Deskripsi |
|---|---|
| Supported |
Manajemen vendor jarak jauh didukung. |
| Unsupported |
Manajemen vendor jarak jauh tidak didukung. |
RemoteVendorManagementStatus
Indikator apakah fitur manajemen vendor jarak jauh diaktifkan atau dinonaktifkan, atau tidak didukung jika fitur tersebut adalah fitur yang tidak didukung.
| Nilai | Deskripsi |
|---|---|
| Enabled |
Manajemen vendor jarak jauh diaktifkan. |
| Disabled |
Manajemen vendor jarak jauh dinonaktifkan. |
| Unsupported |
Manajemen vendor jarak jauh tidak didukung. |
SecretArchiveReference
SecretArchiveReference mewakili referensi ke rahasia di brankas kunci.
| Nama | Jenis | Deskripsi |
|---|---|---|
| keyVaultId |
string (arm-id) |
ID sumber daya brankas kunci yang berisi rahasia. |
| keyVaultUri |
string (uri) |
URI kunci yang berisi rahasia. |
| secretName |
string |
Nama rahasia di brankas kunci. |
| secretVersion |
string |
Versi rahasia di brankas kunci. |
SecretRotationStatus
SecretRotationStatus mewakili status rotasi rahasia.
| Nama | Jenis | Deskripsi |
|---|---|---|
| expirePeriodDays |
integer (int64) |
Jumlah hari maksimum rahasia dapat digunakan sebelum harus diubah. |
| lastRotationTime |
string (date-time) |
Tanggal dan waktu ketika rahasia terakhir diubah. |
| rotationPeriodDays |
integer (int64) |
Jumlah hari rahasia ada sebelum rotasi akan dicoba. |
| secretArchiveReference |
Referensi ke rahasia di brankas kunci. |
|
| secretType |
string |
Nama jenis yang digunakan untuk mengidentifikasi tujuan rahasia. |
StorageAppliance
StorageAppliance mewakili appliance penyimpanan Network Cloud lokal.
| Nama | Jenis | Deskripsi |
|---|---|---|
| etag |
string |
"Jika etag disediakan dalam badan respons, itu juga dapat disediakan sebagai header sesuai konvensi etag normal. Tag entitas digunakan untuk membandingkan dua entitas atau lebih dari sumber daya yang diminta yang sama. HTTP/1.1 menggunakan tag entitas di bidang header etag (bagian 14.19), If-Match (bagian 14.24), If-None-Match (bagian 14.26), dan If-Range (bagian 14.27).") |
| extendedLocation |
Lokasi sumber daya yang diperluas. Properti ini diperlukan saat membuat sumber daya. |
|
| id |
string (arm-id) |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| location |
string |
Lokasi geografis tempat sumber daya berada |
| name |
string |
Nama sumber daya |
| properties.administratorCredentials |
Kredensial antarmuka administratif pada appliance penyimpanan ini. |
|
| properties.caCertificate |
Informasi sertifikat CA yang dikeluarkan oleh platform untuk menghubungkan ke antarmuka TLS untuk alat penyimpanan. Pemanggil menambahkan sertifikat ini ke penyimpanan CA tepercaya mereka untuk memungkinkan komunikasi aman dengan alat penyimpanan. |
|
| properties.capacity |
integer (int64) |
Kapasitas total alat penyimpanan. Diukur dalam GiB. |
| properties.capacityUsed |
integer (int64) |
Jumlah penyimpanan yang dikonsumsi. Diukur dalam GiB. |
| properties.clusterId |
string (arm-id) |
ID sumber daya kluster yang terkait dengan appliance penyimpanan ini. |
| properties.detailedStatus |
Status terperinci dari alat penyimpanan. |
|
| properties.detailedStatusMessage |
string |
Pesan deskriptif tentang status terperinci saat ini. |
| properties.managementIpv4Address |
string |
Titik akhir untuk antarmuka manajemen appliance penyimpanan. |
| properties.manufacturer |
string |
Produsen alat penyimpanan. |
| properties.model |
string |
Model alat penyimpanan. |
| properties.provisioningState |
Status penyediaan alat penyimpanan. |
|
| properties.rackId |
string (arm-id) |
ID sumber daya rak tempat appliance penyimpanan ini berada. |
| properties.rackSlot |
integer (int64) minimum: 1maximum: 256 |
Slot appliance penyimpanan berada di rak berdasarkan konfigurasi BOM. |
| properties.remoteVendorManagementFeature |
Indikator apakah alat penyimpanan mendukung manajemen vendor jarak jauh. |
|
| properties.remoteVendorManagementStatus |
Indikator apakah fitur manajemen vendor jarak jauh diaktifkan atau dinonaktifkan, atau tidak didukung jika fitur tersebut adalah fitur yang tidak didukung. |
|
| properties.secretRotationStatus |
Daftar status yang mewakili aktivitas rotasi rahasia. |
|
| properties.serialNumber |
string |
Nomor seri untuk appliance penyimpanan. |
| properties.storageApplianceSkuId |
string |
SKU untuk appliance penyimpanan. |
| properties.version |
string |
Versi alat penyimpanan. |
| systemData |
Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy. |
|
| tags |
object |
Tag sumber daya. |
| type |
string |
Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
StorageApplianceDetailedStatus
Status terperinci dari alat penyimpanan.
| Nilai | Deskripsi |
|---|---|
| Available |
Status Tersedia. |
| Degraded |
Status Degraded. |
| Error |
Status Kesalahan. |
| Provisioning |
Status Penyediaan. |
StorageAppliancePatchParameters
StorageAppliancePatchParameters mewakili isi permintaan untuk menambal properti appliance penyimpanan.
| Nama | Jenis | Deskripsi |
|---|---|---|
| properties.serialNumber |
string |
Nomor seri untuk appliance penyimpanan. |
| tags |
object |
Tag sumber daya. |
StorageApplianceProvisioningState
Status penyediaan alat penyimpanan.
| Nilai | Deskripsi |
|---|---|
| Succeeded |
Status Berhasil. |
| Failed |
Status Gagal. |
| Canceled |
Status Dibatalkan. |
| Provisioning |
Status Penyediaan. |
| Accepted |
Status Diterima. |
systemData
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
| Nama | Jenis | Deskripsi |
|---|---|---|
| createdAt |
string (date-time) |
Tanda waktu pembuatan sumber daya (UTC). |
| createdBy |
string |
Identitas yang membuat sumber daya. |
| createdByType |
Jenis identitas yang membuat sumber daya. |
|
| lastModifiedAt |
string (date-time) |
Tanda waktu modifikasi terakhir sumber daya (UTC) |
| lastModifiedBy |
string |
Identitas yang terakhir mengubah sumber daya. |
| lastModifiedByType |
Jenis identitas yang terakhir memodifikasi sumber daya. |