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
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

storageApplianceName
path True

string

pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$

Nama appliance penyimpanan.

subscriptionId
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

StorageAppliance

Operasi Azure berhasil diselesaikan.

202 Accepted

Permintaan pembaruan sumber daya diterima.

Header

  • Azure-AsyncOperation: string
  • Location: string
Other Status Codes

ErrorResponse

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
AdministrativeCredentials

AdministrativeCredentials mewakili kredensial admin untuk perangkat yang memerlukan autentikasi berbasis kata sandi.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Jenis kompleks lokasi yang diperluas.

CertificateInfo

CertificateInfo mewakili informasi non-pribadi dari Sertifikat X.509.

createdByType

Jenis identitas yang membuat sumber daya.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Tanggapan kesalahan

ExtendedLocationType

Jenis lokasi yang diperluas.

RemoteVendorManagementFeature

Indikator apakah alat penyimpanan mendukung manajemen vendor jarak jauh.

RemoteVendorManagementStatus

Indikator apakah fitur manajemen vendor jarak jauh diaktifkan atau dinonaktifkan, atau tidak didukung jika fitur tersebut adalah fitur yang tidak didukung.

SecretArchiveReference

SecretArchiveReference mewakili referensi ke rahasia di brankas kunci.

SecretRotationStatus

SecretRotationStatus mewakili status rotasi rahasia.

StorageAppliance

StorageAppliance mewakili appliance penyimpanan Network Cloud lokal.

StorageApplianceDetailedStatus

Status terperinci dari alat penyimpanan.

StorageAppliancePatchParameters

StorageAppliancePatchParameters mewakili isi permintaan untuk menambal properti appliance penyimpanan.

StorageApplianceProvisioningState

Status penyediaan alat penyimpanan.

systemData

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

ExtendedLocationType

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

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Tanggapan kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

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

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

Azure.ResourceManager.CommonTypes.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

AdministrativeCredentials

Kredensial antarmuka administratif pada appliance penyimpanan ini.

properties.caCertificate

CertificateInfo

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

StorageApplianceDetailedStatus

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

StorageApplianceProvisioningState

Status penyediaan alat penyimpanan.

properties.rackId

string (arm-id)

ID sumber daya rak tempat appliance penyimpanan ini berada.

properties.rackSlot

integer (int64)

minimum: 1
maximum: 256

Slot appliance penyimpanan berada di rak berdasarkan konfigurasi BOM.

properties.remoteVendorManagementFeature

RemoteVendorManagementFeature

Indikator apakah alat penyimpanan mendukung manajemen vendor jarak jauh.

properties.remoteVendorManagementStatus

RemoteVendorManagementStatus

Indikator apakah fitur manajemen vendor jarak jauh diaktifkan atau dinonaktifkan, atau tidak didukung jika fitur tersebut adalah fitur yang tidak didukung.

properties.secretRotationStatus

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

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

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

createdByType

Jenis identitas yang terakhir memodifikasi sumber daya.