Storage Appliances - Update

A megadott tárolóberendezés frissítési tulajdonságai, vagy a tárolóberendezés tulajdonságaihoz és címkéihez társított frissítési címkék egymástól függetlenül is elvégezhetők.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/storageAppliances/{storageApplianceName}?api-version=2025-09-01

URI-paraméterek

Name In Kötelező Típus Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

storageApplianceName
path True

string

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

A tárolóberendezés neve.

subscriptionId
path True

string (uuid)

A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.

api-version
query True

string

minLength: 1

A művelethez használandó API-verzió.

Kérelem fejléce

Name Kötelező Típus Description
If-Match

string

Az átalakítás ETagje. Hagyja ki ezt az értéket, hogy mindig felülírja az aktuális erőforrást. Adja meg az utolsóként látott ETag értéket, hogy megakadályozza az egyidejű módosítások véletlen felülírását.

If-None-Match

string

Állítsa a "*" értékre egy új rekordhalmaz létrehozásának engedélyezéséhez, de egy meglévő erőforrás frissítésének megakadályozásához. A többi érték hibát fog eredményezni a kiszolgálótól, mivel azok nem támogatottak.

Kérelem törzse

Name Típus Description
properties.serialNumber

string

A tárolóberendezés sorozatszáma.

tags

object

Erőforráscímkék.

Válaszok

Name Típus Description
200 OK

StorageAppliance

Az Azure működése sikeresen befejeződött.

202 Accepted

Az erőforrás-frissítési kérelem elfogadva.

Fejlécek

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

ErrorResponse

Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name Description
user_impersonation a felhasználói fiók megszemélyesítése

Példák

Patch storage appliance

Mintakérelem

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"
  }
}

Mintaválasz

{
  "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

Definíciók

Name Description
AdministrativeCredentials

Az AdminriviveCredentials a jelszóalapú hitelesítést igénylő eszköz rendszergazdai hitelesítő adatait jelöli.

Azure.ResourceManager.CommonTypes.ExtendedLocation

A kiterjesztett hely összetett típusa.

CertificateInfo

A CertificateInfo az X.509 tanúsítvány nem személyes adatait jelöli.

createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ExtendedLocationType

A kiterjesztett hely típusa.

RemoteVendorManagementFeature

Annak jelzője, hogy a tárolóberendezés támogatja-e a távoli szállítókezelést.

RemoteVendorManagementStatus

Annak jelzője, hogy a távoli szállítókezelési funkció engedélyezve vagy letiltva van-e, vagy nem támogatott, ha nem támogatott szolgáltatásról van szó.

SecretArchiveReference

A SecretArchiveReference egy kulcstartóban található titkos kulcsra mutató hivatkozást jelöl.

SecretRotationStatus

A SecretRotationStatus a titkos rotáció állapotát jelöli.

StorageAppliance

A StorageAppliance a helyszíni hálózati felhőalapú tárolóberendezést jelöli.

StorageApplianceDetailedStatus

A tárolókészülék részletes állapota.

StorageAppliancePatchParameters

StorageAppliancePatchParameters a tárolóberendezés tulajdonságainak javítására vonatkozó kérés törzsét jelöli.

StorageApplianceProvisioningState

A tárolóberendezés kiépítési állapota.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

AdministrativeCredentials

Az AdminriviveCredentials a jelszóalapú hitelesítést igénylő eszköz rendszergazdai hitelesítő adatait jelöli.

Name Típus Description
password

string (password)

minLength: 1

Az inicializálás során használt eszköz rendszergazdájának jelszava.

username

string

minLength: 1

Az inicializálás során használt eszköz rendszergazdájának felhasználóneve.

Azure.ResourceManager.CommonTypes.ExtendedLocation

A kiterjesztett hely összetett típusa.

Name Típus Description
name

string

A kiterjesztett hely neve.

type

ExtendedLocationType

A kiterjesztett hely típusa.

CertificateInfo

A CertificateInfo az X.509 tanúsítvány nem személyes adatait jelöli.

Name Típus Description
hash

string

Az X.509 tanúsítvány kivonatértéke.

value

string

Az X.509 tanúsítvány szöveges értéke.

createdByType

Az erőforrást létrehozó identitás típusa.

Érték Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

ExtendedLocationType

A kiterjesztett hely típusa.

Érték Description
EdgeZone

Azure Edge Zones helytípus

CustomLocation

Azure Custom Locations típusa

RemoteVendorManagementFeature

Annak jelzője, hogy a tárolóberendezés támogatja-e a távoli szállítókezelést.

Érték Description
Supported

A távoli beszállítói menedzsment támogatott.

Unsupported

A távoli beszállítói menedzsment nem támogatott.

RemoteVendorManagementStatus

Annak jelzője, hogy a távoli szállítókezelési funkció engedélyezve vagy letiltva van-e, vagy nem támogatott, ha nem támogatott szolgáltatásról van szó.

Érték Description
Enabled

A távoli beszállítói menedzsment engedélyezve van.

Disabled

A távoli beszállítói menedzsment le van tiltva.

Unsupported

A távoli beszállítói menedzsment nem támogatott.

SecretArchiveReference

A SecretArchiveReference egy kulcstartóban található titkos kulcsra mutató hivatkozást jelöl.

Name Típus Description
keyVaultId

string (arm-id)

A titkos kulcsot tartalmazó kulcstartó erőforrás-azonosítója.

keyVaultUri

string (uri)

A titkos kulcsot tartalmazó kulcs URI-ja.

secretName

string

A kulcstartóban található titkos kulcs neve.

secretVersion

string

A titkos kulcs verziója a kulcstartóban.

SecretRotationStatus

A SecretRotationStatus a titkos rotáció állapotát jelöli.

Name Típus Description
expirePeriodDays

integer (int64)

A titkos kód módosítása előtti napok maximális száma.

lastRotationTime

string (date-time)

A titok utolsó módosításának dátuma és időpontja.

rotationPeriodDays

integer (int64)

A titkos kód napjainak száma a rotációs kísérlet előtt.

secretArchiveReference

SecretArchiveReference

A kulcstartóban található titkos kulcsra mutató hivatkozás.

secretType

string

A titkos kulcs céljának azonosítására használt típusnév.

StorageAppliance

A StorageAppliance a helyszíni hálózati felhőalapú tárolóberendezést jelöli.

Name Típus Description
etag

string

"Ha az etag meg van adva a válasz törzsében, akkor a normál etag konvenció szerint fejlécként is megadható. Az entitáscímkék két vagy több entitás egyazon kért erőforrásból való összehasonlítására szolgálnak. A HTTP/1.1 entitáscímkéket használ az etag (14.19. szakasz), a If-Match (14.24. szakasz), az If-None-Match (14.26. szakasz) és a If-Range (14.27. szakasz) fejlécmezőkben.")

extendedLocation

Azure.ResourceManager.CommonTypes.ExtendedLocation

Az erőforrás kiterjesztett elhelyezkedése. Ez a tulajdonság szükséges az erőforrás létrehozásakor.

id

string (arm-id)

Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Az a földrajzi hely, ahol az erőforrás él

name

string

Az erőforrás neve

properties.administratorCredentials

AdministrativeCredentials

A tárolóberendezés felügyeleti felületének hitelesítő adatai.

properties.caCertificate

CertificateInfo

A platform által kiadott hitelesítésszolgáltatói tanúsítvány adatai a tárolóberendezés TLS-interfészeihez való csatlakozáshoz. A hívók hozzáadják ezt a tanúsítványt a megbízható hitelesítésszolgáltatói tárolójukhoz, hogy biztonságos kommunikációt biztosítsanak a tárolóberendezéssel.

properties.capacity

integer (int64)

A tárolókészülék teljes kapacitása. GiB-ben mérve.

properties.capacityUsed

integer (int64)

Az elfogyasztott tárhely mennyisége. GiB-ben mérve.

properties.clusterId

string (arm-id)

Annak a fürtnek az erőforrás-azonosítója, amelyhez a tárolóberendezés társítva van.

properties.detailedStatus

StorageApplianceDetailedStatus

A tárolókészülék részletes állapota.

properties.detailedStatusMessage

string

Az aktuális részletes állapotról szóló leíró üzenet.

properties.managementIpv4Address

string

A tárolóberendezés felügyeleti felületének végpontja.

properties.manufacturer

string

A tárolókészülék gyártója.

properties.model

string

A tárolókészülék modellje.

properties.provisioningState

StorageApplianceProvisioningState

A tárolóberendezés kiépítési állapota.

properties.rackId

string (arm-id)

Annak az állványnak az erőforrás-azonosítója, ahol ez a tárolóberendezés található.

properties.rackSlot

integer (int64)

minimum: 1
maximum: 256

A tárolóberendezés a BOM konfigurációja alapján az állványon található.

properties.remoteVendorManagementFeature

RemoteVendorManagementFeature

Annak jelzője, hogy a tárolóberendezés támogatja-e a távoli szállítókezelést.

properties.remoteVendorManagementStatus

RemoteVendorManagementStatus

Annak jelzője, hogy a távoli szállítókezelési funkció engedélyezve vagy letiltva van-e, vagy nem támogatott, ha nem támogatott szolgáltatásról van szó.

properties.secretRotationStatus

SecretRotationStatus[]

A titkos rotációs tevékenységet képviselő állapotok listája.

properties.serialNumber

string

A tárolóberendezés sorozatszáma.

properties.storageApplianceSkuId

string

A tárolóberendezés termékváltozata.

properties.version

string

A tárolókészülék verziója.

systemData

systemData

A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.

tags

object

Erőforráscímkék.

type

string

Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

StorageApplianceDetailedStatus

A tárolókészülék részletes állapota.

Érték Description
Available

Az Elérhető állapot.

Degraded

A lealacsonyított státusz.

Error

A hiba állapot.

Provisioning

A Provisioning státusz.

StorageAppliancePatchParameters

StorageAppliancePatchParameters a tárolóberendezés tulajdonságainak javítására vonatkozó kérés törzsét jelöli.

Name Típus Description
properties.serialNumber

string

A tárolóberendezés sorozatszáma.

tags

object

Erőforráscímkék.

StorageApplianceProvisioningState

A tárolóberendezés kiépítési állapota.

Érték Description
Succeeded

A Successed státusz.

Failed

A Sikertelen státusz.

Canceled

A törölt státusz.

Provisioning

A Provisioning státusz.

Accepted

Az Elfogadott státusz.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string (date-time)

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string (date-time)

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást legutóbb módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.