Aggiornamento alla versione " 2026-09-01 " (modifica del numero di " vCPU " nel profilo dell'istanza)

Come descritto nella politica di gestione delle versioni del riferimento alle API VPC, la maggior parte delle modifiche apportate alle API VPC è pienamente retrocompatibile e viene resa disponibile a tutti i client, indipendentemente dalla versione dell'API richiesta dal client. Tuttavia, la versione " 2026-09-01 " dell'API VPC richiederà modifiche incompatibili per supportare una modellazione aggiornata dei valori relativi al numero di vCPU i nei profili delle istanze.

Prima di passare alla versione 2026-09-01 o successive, esamina le modifiche descritte nella presente guida alla migrazione che potrebbero richiedere l'aggiornamento del client.

Proprietà del profilo dell'istanza modificate

Le seguenti proprietà subiranno delle modifiche per le richieste API che utilizzano un parametro di query della versione pari a 2026-09-01 o successive.

Durante il recupero o l'elenco dei profili delle istanze, le seguenti proprietà subiranno delle modifiche per le richieste API che utilizzano il parametro di query version con valore 2026-09-01 o successivo.

Modifiche alle proprietà durante il recupero o l'elenco dei profili delle istanze.
Proprietà modificata Modifica
vcpu_count Il valore fisso unico verrà rimosso e sostituito con un array.
supported_vcpu_count Verrà rimosso dalla risposta.

Per le versioni dell'API precedenti a 2026-09-01, vcpu_count può essere restituito come valore fisso e supported_vcpu_count contiene i valori dell'enumerazione supportati. Per le versioni dell'API 2026-09-01 o successive, il campo supported_vcpu_count verrà rimosso dalla risposta e il campo vcpu_count conterrà direttamente i valori consentiti quando il profilo restituisce un valore basato su un'enumerazione.

Azione necessaria

Prima di specificare il parametro di query version con valore 2026-09-01 o successivo, segui queste istruzioni per evitare regressioni nelle funzionalità del client.

Se il tuo client utilizza l'indirizzo supported_vcpu_count.values, aggiornalo in modo che riporti invece l'indirizzo vcpu_count.values.

Se il cliente presume che vcpu_count contenga sempre un value fisso, aggiornarlo in modo che gestisca la risposta supportata per vcpu_count, inclusi i valori basati su enumerazione, su intervallo e dipendenti.

Se i vostri clienti continuano a richiedere una versione precedente a 2026-09-01, non è necessario apportare alcuna modifica.

Migrazione dei clienti

Prima di effettuare la migrazione di un client alla versione API 2026-09-01 o successive, controlla il codice che utilizza i seguenti metodi:

  • GET /instance/profiles/{name}
  • GET /instance/profiles

Esamina le modifiche che verranno annunciate nel registro delle modifiche dell'API e verifica che il tuo codice le adotti in modo adeguato al tuo linguaggio di programmazione.

Esempio

Gli esempi seguenti mostrano la risposta prima e dopo la modifica della versione dell'API 2026-09-01.

Recupero di un profilo di istanza

La risposta che segue è relativa a una richiesta che utilizza una versione dell'API precedente a 2026-09-01. La proprietà vcpu_count contiene un valore fisso, mentre supported_vcpu_count contiene i valori supportati.

{
  "name": "bx2-custom",
  "resource_type": "instance_profile",
  "vcpu_count": {
    "type": "fixed",
    "value": 4
  },
  "supported_vcpu_count": {
    "type": "enum",
    "values": [2, 4]
  }
}