Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
L'API REST di Azure NetApp Files versione 2026-07-01 introduce modifiche ai modelli utilizzati per aggiornare gli account NetApp con PATCH. Se utilizzi l'API Azure NetApp Files REST, Azure SDK o un'automazione che aggiorna gli account NetApp, verifica queste modifiche prima di adottare la versione API 2026-07-01 o un SDK basato su questa versione API.
Importante
Questi cambiamenti riguardano solo PATCH .../netAppAccounts/{accountName} i payload di richiesta. Non è richiesta alcuna azione per le chiamate esistenti PUTGET .
Cosa cambia
A partire dalla versione API 2026-07-01, i PATCH corpi delle richieste per gli account NetApp utilizzano modelli di aggiornamento dedicati invece di riutilizzare l'intero modello di risorse.
Come parte di questa modifica:
- Le proprietà di sola lettura e quelle assegnate al server vengono rimosse dal contratto di aggiornamento.
- Le proprietà richieste solo nella creazione di una risorsa sono opzionali al momento dell'aggiornamento.
- I valori predefiniti dello schema vengono rimossi dal contratto di aggiornamento così i valori omessi non vengono riapplicati durante un aggiornamento.
- Alcuni campi segreti sono identificati come password per la gestione degli SDK e degli strumenti.
- L'API stabile definisce una capacità massima di volume Azure NetApp Files di 2.400 TiB.
Nuovi modelli PATCH
I seguenti modelli dedicati sono utilizzati per le operazioni di aggiornamento:
| Nuovo modello | Sostituisce il corpo PATCH | Tratto da |
|---|---|---|
AccountPropertiesPatch |
AccountProperties |
NetAppAccountPatch.properties |
ActiveDirectoryPatch |
ActiveDirectory |
AccountPropertiesPatch.activeDirectories[] |
AccountEncryptionPatch |
AccountEncryption |
AccountPropertiesPatch.encryption |
KeyVaultPropertiesPatch |
KeyVaultProperties |
AccountEncryptionPatch.keyVaultProperties |
EncryptionIdentityPatch |
EncryptionIdentity |
AccountEncryptionPatch.identity |
Il NetAppAccountPatch nome del modello è rimasto invariato, ma le proprietà supportate dal modello sono state aggiornate.
Proprietà rimosse dalle richieste PATCH
Le seguenti proprietà non fanno più parte del contratto di aggiornamento perché sono in sola lettura, assegnate dal server o immutabili dopo la creazione delle risorse. Queste proprietà restano disponibili tramite GET e PUT risposte.
| Model | Proprietà rimossa | Reason |
|---|---|---|
NetAppAccountPatch |
id |
Server assegnato, sola lettura |
NetAppAccountPatch |
name |
Server assegnato, sola lettura |
NetAppAccountPatch |
type |
Server assegnato, sola lettura |
NetAppAccountPatch |
location |
Immutabile dopo la creazione |
AccountPropertiesPatch |
provisioningState |
Sola lettura |
AccountPropertiesPatch |
disableShowmount |
Sola lettura |
AccountPropertiesPatch |
multiAdStatus |
Sola lettura |
ActiveDirectoryPatch |
status |
Sola lettura |
ActiveDirectoryPatch |
statusDetails |
Sola lettura |
KeyVaultPropertiesPatch |
keyVaultId |
Sola lettura |
KeyVaultPropertiesPatch |
status |
Sola lettura |
EncryptionIdentityPatch |
principalId |
Sola lettura |
In precedenza, queste proprietà potevano essere incluse nelle PATCH richieste ma venivano ignorate. I client REST che costruiscono PATCH organi di richiesta dovrebbero smettere di includerli. I client che eseguono una validazione rigorosa dello schema devono utilizzare il nuovo contratto di aggiornamento.
Le proprietà di Key Vault sono opzionali durante gli aggiornamenti
Le seguenti proprietà non sono più richieste quando si aggiornano le impostazioni di Key Vault:
| Model | Proprietà | Cambia |
|---|---|---|
KeyVaultPropertiesPatch |
keyVaultUri |
Da obbligatorio a facoltativo |
KeyVaultPropertiesPatch |
keyName |
Da obbligatorio a facoltativo |
Questo comportamento è coerente con la semantica JSON Merge Patch. Se ometti una di queste proprietà da una PATCH richiesta, il suo valore esistente rimane invariato.
I valori predefiniti non vengono applicati durante le operazioni PATCH
I valori predefiniti dello schema non vengono più applicati alle operazioni PATCH per le proprietà seguenti:
| Model | Proprietà | Predefinito indicato in precedenza |
|---|---|---|
ActiveDirectoryPatch |
organizationalUnit |
CN=Computers |
AccountEncryptionPatch |
keySource |
Microsoft.NetApp |
Se ometti una delle due proprietà da una richiesta di aggiornamento, il suo valore esistente rimane invariato invece di essere reimpostato al valore predefinito precedentemente pubblicizzato.
Se la tua automazione dipende dal fatto che uno dei valori predefiniti venga riapplicato durante un aggiornamento, specifica esplicitamente il valore richiesto nella PATCH richiesta.
I campi segreti sono identificati come password
Le seguenti proprietà sono dichiarate con format: password così che SDK e strumenti possano trattare i loro valori come segreti e oscurarli in log o tracce:
| Model | Proprietà |
|---|---|
PeeringPassphrases |
clusterPeeringPassphrase |
ClusterPeerCommandResponseProperties |
passphrase |
I valori delle proprietà e il tipo di filo (string) sono rimasti invariati.
Limite di capacità di volume
Per la versione API 2026-07-01, il valore massimo per usageThreshold su VolumeProperties e VolumePatchProperties è 2.638.827.906.662.400 byte (2.400 TiB).
Il massimo di 7.200 TiB rimane disponibile solo con l'anteprima dell'API 2026-07-15.
La capacità minima di volume di 50 GiB e la potenza predefinita di 100 GiB rimangono invariate.
Se la tua applicazione o automazione prevede o aggiorna volumi superiori a 2.400 TiB, continua a utilizzare la versione preview API.
Azione richiesta
Rivedi come le tue applicazioni e l'automazione utilizzano Azure NetApp Files prima di aggiornare alla versione API 2026-07-01 o a un SDK basato su questa versione API.
Chiamanti API REST
Rimuovi dal corpo delle richieste degli account NetApp PATCH le proprietà di sola lettura, assegnate dal server e immutabili elencate in questo articolo. Queste proprietà erano precedentemente ignorate ma non sono più incluse nello schema di aggiornamento.
Utenti di Azure SDK
Quando si esegue l'aggiornamento a un SDK generato dalla versione API 2026-07-01, aggiornare i siti della chiamata PATCH dell'account NetApp in modo che usino le classi del nuovo modello di aggiornamento. Ad esempio, usare ActiveDirectoryPatch invece di ActiveDirectory quando si costruisce il payload di aggiornamento corrispondente.
Le operazioni di lettura non sono influenzate.
Utenti dell'automazione e dell'infrastruttura come codice
Rivedi l'automazione o i template che impostano organizationalUnit o keySource e che dipendono dalla riapplicazione delle rispettive impostazioni predefinite durante un aggiornamento. Specifica queste proprietà esplicitamente quando il tuo aggiornamento richiede un valore particolare.
Configurazioni di volumi
Se la tua distribuzione richiede volumi superiori a 2.400 TiB, continua a usare l'API versione 2026-07-15-preview. L'API stabile del 01-07-2026 supporta un massimo di 2.400 TiB.