Skip to main content
Astra Automation
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Modificare una licenza

PDF

PUT /accounts/{account_id}/core/v1/licenses/{license_id}

Sostituisce l'intera risorsa memorizzata con il corpo della richiesta JSON fornito, preservando i valori chiave non modificabili dall'utente.

Effetti collaterali

  • I diritti di licenza vengono ricalcolati per aggiungere o unire i diritti di licenza visibili tramite l'API dei diritti di licenza.

Parametri

Nome Tipo In Obbligatorio Descrizione

ID account

stringa

percorso

Vero

ID della risorsa account contenitore

  • esempio: {{.Account}}

ID licenza

stringa

percorso

Vero

ID della raccolta di licenze da elencare

Corpo della richiesta

Sostituisce l'intera risorsa memorizzata con il corpo della richiesta JSON fornito, preservando i valori chiave non modificabili dall'utente.

Effetti collaterali

  • I diritti di licenza vengono ricalcolati per aggiungere o unire i diritti di licenza visibili tramite l'API dei diritti di licenza.

Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

Tipo di media della risorsa. I valori definiti sono:

  • "application/astra-license"

versione

stringa

Vero

Versione della risorsa. I valori definiti sono:

  • "1,0"

id

stringa

Falso

Identificatore univoco globale della risorsa. I valori definiti sono:

  • Conforme allo schema UUIDv4

allocazione

stringa

Falso

Stringa JSON contenente un ID che indica a cosa è assegnata la licenza. Presente solo quando la licenza è assegnata. Per le licenze di Astra Control Center, questo campo deve essere compilato con l'ID dell'account e deve corrispondere all'ID dell'account specificato nell'URI POST. I valori definiti sono:

  • Conforme allo schema identificativo Astra

ID host

stringa

Falso

Stringa JSON contenente un identificatore host a cui è associata una licenza. Presente solo se la licenza è vincolata a un host. I valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 63

ID credenziali del dispositivo

stringa

Falso

Stringa JSON contenente l'identificativo del deviceCredential associato all'API delle credenziali. Presente solo per le licenze Astra Data Store. I valori definiti sono:

  • Conforme allo schema identificativo Astra

isEvaluation

stringa

Falso

Stringa JSON che indica se la licenza è una licenza di valutazione. I valori definiti sono:

  • "true"

  • "false"

licenseProtocol

stringa

Falso

Stringa JSON contenente il protocollo di licenza estratto dalla licenza. I valori definiti sono:

  • Il contenuto della stringa non è convalidato dallo schema

licenseText

stringa

Falso

Stringa JSON contenente una rappresentazione codificata in base64 della licenza JSON ottenuta dal sistema di licenze NetApp. Questa deve essere fornita nell'ordine originale a livello di byte per consentire la verifica della firma. I valori definiti sono:

  • Conforme allo schema di dati codificati in base64

validFromTimestamp

stringa

Falso

Stringa JSON contenente un timestamp che indica quando la licenza diventa valida. I valori definiti sono:

  • Conforme allo schema di data e ora ISO-8601

validUntilTimestamp

stringa

Falso

Stringa JSON contenente un timestamp che indica quando la licenza non è più valida. I valori definiti sono:

  • Conforme allo schema di data e ora ISO-8601

prodotto

stringa

Falso

Stringa JSON contenente la stringa del prodotto estratta dalla licenza. I valori definiti sono:

  • Il contenuto della stringa non è convalidato dallo schema

productVersion

stringa

Falso

Stringa JSON contenente la stringa della versione estratta dalla licenza. I valori definiti sono:

  • Il contenuto della stringa non è convalidato dallo schema

productSN

stringa

Falso

Stringa JSON contenente il numero di serie estratto dalla licenza. I valori definiti sono:

  • Il contenuto della stringa non è convalidato dallo schema

caratteristiche

stringa

Falso

Stringa JSON contenente il valore del pacchetto estratto dalla licenza. I valori definiti sono:

  • Il contenuto della stringa non è convalidato dallo schema

capacità

stringa

Falso

Stringa JSON contenente la capacità estratta dalla licenza.

capacity2

stringa

Falso

Stringa JSON contenente la capacità secondaria estratta dalla licenza.

componenti aggiuntivi

vettore["componenti aggiuntivi"]

Falso

Array JSON di oggetti JSON contenente l'elenco dei componenti aggiuntivi della licenza. Un componente aggiuntivo è una modifica alla licenza che potrebbe verificarsi in una data futura.

metadati

"aggiornamento dei metadati di tipo Astra"

Falso

Metadati specificati dal client e dal servizio associati alla risorsa. I valori definiti sono:

  • Conforme allo schema dei metadati Astra. Se non specificato in fase di creazione, verrà creato un oggetto metadati senza etichette. Se non specificato in fase di aggiornamento, le etichette dell'oggetto metadati, creationTimestamp e createdBy, verranno conservate senza modifiche.
Esempio di richiesta 
{
  "type": "application/astra-license",
  "version": "1.0",
  "allocation": "4185d09b-6687-4801-a832-c005a9d94f41",
  "licenseText": "ewogICAic3RhdHVzUmVzcCI6ewogMTYwNzAwIgp9"
}

Risposta

Status: 204, Indicates if the license resource was updated.

Risposta

Status: 401, Unauthorized
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Risposta

Status: 400, Bad request
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Risposta

Status: 409, Conflict
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso

invalidFields

vettore["invalidFields"]

Falso

Elenco dei campi non validi del corpo della richiesta
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

Risposta

Status: 403, Forbidden
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Errore

Status: 404, Not found
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso
Esempio di risposta di errore 
{
  "type": "https://astra.netapp.io/problems/1",
  "title": "Resource not found",
  "detail": "The resource specified in the request URI wasn't found.",
  "status": "404"
}

Definizioni

Vedi definizioni

componenti aggiuntivi

Nome Tipo Obbligatorio Descrizione

startDate

stringa

Falso

Stringa JSON contenente un timestamp che indica quando questo componente aggiuntivo diventa valido. I valori definiti sono:

  • Conforme allo schema di data e ora ISO-8601

endDate

stringa

Falso

Stringa JSON contenente un timestamp che indica quando questo componente aggiuntivo non è più valido. I valori definiti sono:

  • Conforme allo schema di data e ora ISO-8601

caratteristiche

stringa

Falso

Stringa JSON contenente l'elenco delle funzionalità associate a questo componente aggiuntivo. I valori definiti sono:

  • Il contenuto della stringa non è convalidato dallo schema.

capacità

stringa

Falso

Stringa JSON contenente la capacità estratta dal componente aggiuntivo. I valori definiti sono:

  • Il contenuto della stringa non è convalidato dallo schema

licenseProtocol

stringa

Falso

Stringa JSON contenente il protocollo di licenza associato a questo componente aggiuntivo. I valori definiti sono:

  • Il contenuto della stringa non è convalidato dallo schema

etichetta tipo_astra

Nome Tipo Obbligatorio Descrizione

nome

stringa

Vero

valore

stringa

Vero

aggiornamento dei metadati di tipo Astra

Metadati specificati dal client e dal servizio associati alla risorsa. I valori definiti sono:

  • Conforme allo schema dei metadati Astra. Se non specificato in fase di creazione, verrà creato un oggetto metadati senza etichette. Se non specificato in fase di aggiornamento, le etichette dell'oggetto metadati, creationTimestamp e createdBy, verranno conservate senza modifiche.

Nome Tipo Obbligatorio Descrizione

etichette

vettore["etichetta tipo_astra"]

Falso

CreationTimestamp

stringa

Falso

ModificationTimestamp

stringa

Falso

CreatedBy

stringa

Falso

modifiedBy

stringa

Falso

invalidParams

Nome Tipo Obbligatorio Descrizione

nome

stringa

Vero

Nome del parametro di query non valido

motivo

stringa

Vero

Motivo per cui il parametro di query non è valido

invalidFields

Nome Tipo Obbligatorio Descrizione

nome

stringa

Vero

Nome del campo del corpo della richiesta non valido

motivo

stringa

Vero

Motivo per cui il campo del corpo della richiesta non è valido