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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
storage
|
path | True |
string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$ |
Nom de l’appliance de stockage. |
|
subscription
|
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 |
Opération Azure terminée avec succès. |
|
| 202 Accepted |
Demande de mise à jour de ressource acceptée. En-têtes
|
|
| Other Status Codes |
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 |
|---|---|
|
Administrative |
AdministrativeCredentials représente les informations d’identification de l’administrateur pour l’appareil nécessitant une authentification par mot de passe. |
|
Azure. |
Type complexe de l’emplacement étendu. |
|
Certificate |
CertificateInfo représente les informations non privées d’un certificat X.509. |
|
created |
Type d’identité qui a créé la ressource. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
Extended |
Type de l’emplacement étendu. |
|
Remote |
Indicateur indiquant si l’appliance de stockage prend en charge la gestion à distance du fournisseur. |
|
Remote |
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. |
|
Secret |
SecretArchiveReference représente la référence à un secret dans un coffre de clés. |
|
Secret |
SecretRotationStatus représente l’état d’une rotation de secrets. |
|
Storage |
StorageAppliance représente l’appliance de stockage Network Cloud sur site. |
|
Storage |
État détaillé de l’appliance de stockage. |
|
Storage |
StorageAppliancePatchParameters représente le corps de la demande de correctif des propriétés de l’appliance de stockage. |
|
Storage |
État de provisionnement de l’appliance de stockage. |
|
system |
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 |
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 |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
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 |
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 |
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 |
Informations d’identification de l’interface administrative sur cette appliance de stockage. |
|
| properties.caCertificate |
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 |
É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 |
É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: 1maximum: 256 |
L’emplacement de l’appliance de stockage se trouve dans le rack en fonction de la configuration boM. |
| properties.remoteVendorManagementFeature |
Indicateur indiquant si l’appliance de stockage prend en charge la gestion à distance du fournisseur. |
|
| properties.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 |
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 |
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 |
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 |
Type d’identité qui a modifié la ressource pour la dernière fois. |