Storage Appliances - Update

Les propriétés de mise à jour de l’appliance de stockage fournie ou les balises de mise à jour associées aux propriétés de l’appliance de stockage et aux mises à jour des balises peuvent être effectuées indépendamment.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

storageApplianceName
path True

string

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

Nom de l’appliance de stockage.

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom Obligatoire Type Description
If-Match

string

ETag de la transformation. Omettez cette valeur pour toujours remplacer la ressource actuelle. Spécifiez la dernière valeur ETag vue pour empêcher le remplacement accidentel des modifications simultanées.

If-None-Match

string

Définissez sur « * » pour autoriser la création d’un jeu d’enregistrements, mais pour empêcher la mise à jour d’une ressource existante. D’autres valeurs entraînent une erreur du serveur, car elles ne sont pas prises en charge.

Corps de la demande

Nom Type Description
properties.serialNumber

string

Numéro de série de l’appliance de stockage.

tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

StorageAppliance

Opération Azure terminée avec succès.

202 Accepted

Demande de mise à jour de ressource acceptée.

En-têtes

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

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Patch storage appliance

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
AdministrativeCredentials

AdministrativeCredentials représente les informations d’identification de l’administrateur pour l’appareil nécessitant une authentification par mot de passe.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Type complexe de l’emplacement étendu.

CertificateInfo

CertificateInfo représente les informations non privées d’un certificat X.509.

createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ExtendedLocationType

Type de l’emplacement étendu.

RemoteVendorManagementFeature

Indicateur indiquant si l’appliance de stockage prend en charge la gestion à distance du fournisseur.

RemoteVendorManagementStatus

Indicateur indiquant si la fonctionnalité de gestion du fournisseur à distance est activée ou désactivée, ou si elle n’est pas prise en charge s’il s’agit d’une fonctionnalité non prise en charge.

SecretArchiveReference

SecretArchiveReference représente la référence à un secret dans un coffre de clés.

SecretRotationStatus

SecretRotationStatus représente l’état d’une rotation de secrets.

StorageAppliance

StorageAppliance représente l’appliance de stockage Network Cloud sur site.

StorageApplianceDetailedStatus

État détaillé de l’appliance de stockage.

StorageAppliancePatchParameters

StorageAppliancePatchParameters représente le corps de la demande de correctif des propriétés de l’appliance de stockage.

StorageApplianceProvisioningState

État de provisionnement de l’appliance de stockage.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

AdministrativeCredentials

AdministrativeCredentials représente les informations d’identification de l’administrateur pour l’appareil nécessitant une authentification par mot de passe.

Nom Type Description
password

string (password)

minLength: 1

Mot de passe de l’administrateur de l’appareil utilisé lors de l’initialisation.

username

string

minLength: 1

Nom d’utilisateur de l’administrateur de l’appareil utilisé lors de l’initialisation.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Type complexe de l’emplacement étendu.

Nom Type Description
name

string

Nom de l’emplacement étendu.

type

ExtendedLocationType

Type de l’emplacement étendu.

CertificateInfo

CertificateInfo représente les informations non privées d’un certificat X.509.

Nom Type Description
hash

string

Valeur de hachage du certificat X.509.

value

string

Valeur textuelle du certificat X.509.

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ExtendedLocationType

Type de l’emplacement étendu.

Valeur Description
EdgeZone

Type d’emplacement Azure Edge Zones

CustomLocation

Type d’emplacements personnalisés Azure

RemoteVendorManagementFeature

Indicateur indiquant si l’appliance de stockage prend en charge la gestion à distance du fournisseur.

Valeur Description
Supported

La gestion à distance des fournisseurs est prise en charge.

Unsupported

La gestion à distance des fournisseurs n’est pas prise en charge.

RemoteVendorManagementStatus

Indicateur indiquant si la fonctionnalité de gestion du fournisseur à distance est activée ou désactivée, ou si elle n’est pas prise en charge s’il s’agit d’une fonctionnalité non prise en charge.

Valeur Description
Enabled

La gestion à distance des fournisseurs est activée.

Disabled

La gestion à distance des fournisseurs est désactivée.

Unsupported

La gestion à distance des fournisseurs n’est pas prise en charge.

SecretArchiveReference

SecretArchiveReference représente la référence à un secret dans un coffre de clés.

Nom Type Description
keyVaultId

string (arm-id)

ID de ressource du coffre de clés contenant le secret.

keyVaultUri

string (uri)

URI de la clé contenant le secret.

secretName

string

Nom de la clé secrète dans le coffre de clés.

secretVersion

string

Version du secret dans le coffre de clés.

SecretRotationStatus

SecretRotationStatus représente l’état d’une rotation de secrets.

Nom Type Description
expirePeriodDays

integer (int64)

Le nombre maximum de jours pendant lesquels le secret peut être utilisé avant de devoir être modifié.

lastRotationTime

string (date-time)

La date et l’heure de la dernière modification du secret.

rotationPeriodDays

integer (int64)

Nombre de jours pendant lesquels un secret existe avant que les rotations ne soient tentées.

secretArchiveReference

SecretArchiveReference

Référence au secret dans un coffre de clés.

secretType

string

Nom de type utilisé pour identifier l’objectif du secret.

StorageAppliance

StorageAppliance représente l’appliance de stockage Network Cloud sur site.

Nom Type Description
etag

string

« Si etag est fourni dans le corps de la réponse, il peut également être fourni en tant qu’en-tête conformément à la convention etag normale. Les balises d’entité sont utilisées pour comparer deux entités ou plus à partir de la même ressource demandée. HTTP/1.1 utilise des balises d’entité dans les champs d’en-tête etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26) et If-Range (section 14.27).

extendedLocation

Azure.ResourceManager.CommonTypes.ExtendedLocation

L’emplacement étendu de la ressource. Cette propriété est nécessaire lors de la création de la ressource.

id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

location

string

Emplacement géographique où réside la ressource

name

string

Nom de la ressource

properties.administratorCredentials

AdministrativeCredentials

Informations d’identification de l’interface administrative sur cette appliance de stockage.

properties.caCertificate

CertificateInfo

Informations de certificat d’autorité de certification émises par la plate-forme pour la connexion aux interfaces TLS de l’appliance de stockage. Les appelants ajoutent ce certificat à leur magasin d’autorité de certification de confiance pour permettre une communication sécurisée avec l’appliance de stockage.

properties.capacity

integer (int64)

Capacité totale de l’appliance de stockage. Mesuré en Gio.

properties.capacityUsed

integer (int64)

Quantité de stockage consommée. Mesuré en Gio.

properties.clusterId

string (arm-id)

ID de ressource du cluster auquel cette appliance de stockage est associée.

properties.detailedStatus

StorageApplianceDetailedStatus

État détaillé de l’appliance de stockage.

properties.detailedStatusMessage

string

Message descriptif sur l’état détaillé actuel.

properties.managementIpv4Address

string

Point de terminaison de l’interface de gestion de l’appliance de stockage.

properties.manufacturer

string

Le fabricant de l’appareil de stockage.

properties.model

string

Le modèle de l’appareil de stockage.

properties.provisioningState

StorageApplianceProvisioningState

État de provisionnement de l’appliance de stockage.

properties.rackId

string (arm-id)

ID de ressource du rack où réside cette appliance de stockage.

properties.rackSlot

integer (int64)

minimum: 1
maximum: 256

L’emplacement de l’appliance de stockage se trouve dans le rack en fonction de la configuration boM.

properties.remoteVendorManagementFeature

RemoteVendorManagementFeature

Indicateur indiquant si l’appliance de stockage prend en charge la gestion à distance du fournisseur.

properties.remoteVendorManagementStatus

RemoteVendorManagementStatus

Indicateur indiquant si la fonctionnalité de gestion du fournisseur à distance est activée ou désactivée, ou si elle n’est pas prise en charge s’il s’agit d’une fonctionnalité non prise en charge.

properties.secretRotationStatus

SecretRotationStatus[]

La liste des statuts qui représentent l’activité de rotation secrète.

properties.serialNumber

string

Numéro de série de l’appliance de stockage.

properties.storageApplianceSkuId

string

Référence SKU de l’appliance de stockage.

properties.version

string

Version de l’appliance de stockage.

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

StorageApplianceDetailedStatus

État détaillé de l’appliance de stockage.

Valeur Description
Available

Le statut Disponible.

Degraded

Le statut dégradé.

Error

Le statut Erreur.

Provisioning

Le statut de Provision.

StorageAppliancePatchParameters

StorageAppliancePatchParameters représente le corps de la demande de correctif des propriétés de l’appliance de stockage.

Nom Type Description
properties.serialNumber

string

Numéro de série de l’appliance de stockage.

tags

object

Balises de ressource.

StorageApplianceProvisioningState

État de provisionnement de l’appliance de stockage.

Valeur Description
Succeeded

Le statut de Successé.

Failed

Le statut d’échec.

Canceled

Le statut Annulé.

Provisioning

Le statut de Provision.

Accepted

Le statut Accepté.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.