Creare una nuova app per un cluster gestito
POST /accounts/{account_id}/topology/v2/managedClusters/{managedCluster_id}/apps
Indica i valori desiderati per la risorsa API dell'app da creare.
Parametri
| Nome | Tipo | In | Obbligatorio | Descrizione |
|---|---|---|---|---|
ID account |
stringa |
percorso |
Vero |
ID della risorsa account contenitore
|
ID cluster gestito |
stringa |
percorso |
Vero |
ID della risorsa managedCluster contenitore |
Corpo della richiesta
Indica i valori desiderati per la risorsa API dell'app da creare.
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
tipo |
stringa |
Vero |
Tipo di media della risorsa. I valori definiti sono:
|
versione |
stringa |
Vero |
Versione della risorsa. I valori definiti sono:
|
nome |
stringa |
Vero |
Stringa JSON contenente un nome per l'applicazione. I valori definiti sono:
|
clusterScopedResources |
vettore["clusterScopedResources"] |
Falso |
Array JSON di oggetti JSON che descrivono le risorse a livello di cluster che fanno parte di questa app |
namespaceScopedResources |
vettore["namespaceScopedResources"] |
Falso |
Array JSON di oggetti JSON che descrivono le risorse che fanno parte di questa app |
namespaceMapping |
vettore["namespaceMapping"] |
Falso |
Array JSON di oggetti JSON, ciascuno dei quali mappa uno spazio dei nomi di origine a uno spazio dei nomi di destinazione per un'operazione di clonazione. I valori definiti sono:
|
storageClassMapping |
vettore["storageClassMapping"] |
Falso |
Array JSON di oggetti JSON, ognuno dei quali mappa una classe di archiviazione di origine a una classe di archiviazione di destinazione per un'operazione di ripristino. Se non sono presenti elementi o se questi non sono presenti, verranno utilizzati i nomi originali delle classi di archiviazione di origine. I valori definiti sono:
|
clusterID |
stringa |
Falso |
Stringa JSON contenente l'ID del cluster su cui è in esecuzione l'applicazione. Non viene restituita se l'applicazione non è attualmente in esecuzione. Se specificato in fase di creazione, clusterID indica in quale cluster l'applicazione deve essere clonata. Se il cluster specificato non esiste, o se il cluster specificato non corrisponde al clusterID specificato nell'URI della richiesta, la clonazione non riuscirà. I valori definiti sono:
|
ID applicazione sorgente |
stringa |
Falso |
Stringa JSON contenente l'ID di un'applicazione di origine. Viene restituita solo se l'applicazione è stata clonata da un'altra applicazione o è stata ripristinata da un backup o uno snapshot. Quando specificato in fase di creazione, il sourceAppID viene utilizzato insieme al sourceClusterID e indica quale applicazione in esecuzione verrà clonata. Se l'applicazione specificata non esiste sul cluster di origine, la clonazione non riuscirà. È possibile specificare solo uno tra sourceAppID, backupID o snapshotID durante la creazione di un'applicazione. I valori definiti sono:
|
sourceClusterID |
stringa |
Falso |
Stringa JSON contenente l'ID del cluster su cui l'applicazione era precedentemente in esecuzione. Restituita solo se l'applicazione è stata clonata da un altro cluster. Quando specificato in fase di creazione, il sourceClusterID viene utilizzato insieme al sourceAppID e indica il cluster di origine dell'applicazione da clonare. Se il cluster di origine specificato non esiste, la clonazione non andrà a buon fine. I valori definiti sono:
|
backupID |
stringa |
Falso |
Stringa JSON contenente l'ID del backup da cui è stata ripristinata l'applicazione. Restituita solo se l'applicazione è stata ripristinata da un backup. Se specificato in fase di creazione, backupID indica che un'applicazione verrà clonata da un backup esistente. Se il backup specificato non esiste, la clonazione non andrà a buon fine. È possibile specificare solo uno tra sourceAppID, backupID o snapshotID durante la creazione di un'applicazione. Se specificato in fase di sostituzione, backupID indica il backup dell'applicazione da cui verrà ripristinata l'applicazione sul posto. Se il backup specificato non esiste, il ripristino non andrà a buon fine. È possibile specificare solo uno tra backupID o snapshotID durante l'aggiornamento di un'applicazione. I valori definiti sono:
|
snapshotID |
stringa |
Falso |
Stringa JSON contenente l'ID dello snapshot da cui è stata ripristinata l'applicazione. Restituita solo se l'applicazione è stata ripristinata da uno snapshot. Se specificato in fase di creazione, snapshotID indica che un'applicazione verrà clonata da uno snapshot esistente. Se lo snapshot specificato non esiste, la clonazione non andrà a buon fine. È possibile specificare solo uno tra sourceAppID, backupID o snapshotID durante la creazione di un'applicazione. Se specificato in fase di sostituzione, snapshotID indica lo snapshot dell'applicazione da cui verrà ripristinata l'applicazione sul posto. Se lo snapshot specificato non esiste, il ripristino non andrà a buon fine. È possibile specificare solo uno tra backupID o snapshotID durante l'aggiornamento di un'applicazione. I valori definiti sono:
|
restoreFilter |
Falso |
Oggetto JSON contenente un elenco di filtri che descrivono quali risorse sono incluse o escluse da un'operazione di ripristino selettivo. Includi ed escludi si escludono a vicenda e un ripristino selettivo può utilizzare un solo tipo di filtro. |
|
metadati |
Falso |
Metadati specificati dal client e dal servizio associati alla risorsa. I valori definiti sono:
|
Esempio di richiesta
{
"type": "application/astra-app",
"version": "2.2",
"name": "jenkins",
"clusterID": "0f284377-e5dc-4dcd-bacd-3197f2b8a347",
"namespaceScopedResources": [
{
"namespace": "production"
}
]
}
Risposta
Status: 201, Returns the newly created app resource in the JSON response body.
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
tipo |
stringa |
Vero |
Tipo di media della risorsa. I valori definiti sono:
|
versione |
stringa |
Vero |
Versione della risorsa. I valori definiti sono:
|
id |
stringa |
Vero |
Identificatore univoco globale della risorsa. I valori definiti sono:
|
collegamenti |
vettore["type_astra_link"] |
Vero |
Collegamenti che descrivono le operazioni supportate sulla risorsa. |
nome |
stringa |
Vero |
Stringa JSON contenente un nome per l'applicazione. I valori definiti sono:
|
clusterScopedResources |
vettore["clusterScopedResources"] |
Falso |
Array JSON di oggetti JSON che descrivono le risorse a livello di cluster che fanno parte di questa app |
namespaceScopedResources |
vettore["namespaceScopedResources"] |
Vero |
Array JSON di oggetti JSON che descrivono le risorse che fanno parte di questa app |
lastResourceCollectionTimestamp |
stringa |
Falso |
Stringa JSON contenente il timestamp dell'ultima raccolta di risorse. Questo campo non è impostato se non è stata ancora eseguita alcuna raccolta di risorse per questa applicazione. I valori definiti sono:
|
stato |
stringa |
Vero |
Stringa JSON contenente un valore che indica lo stato operativo dell'applicazione. I valori definiti sono:
|
stateTransitions |
vettore["tipo_transizione_stato_astra"] |
Falso |
Array JSON di oggetti JSON, ognuno dei quali rappresenta l'insieme delle transizioni di stato consentite da un dato stato definito. Ogni oggetto JSON contiene i campi "from" e "to", dove il valore di "from" è il nome di uno stato e il valore di "to" è un array degli stati di destinazione consentiti. |
stateDetails |
vettore["type_astra_stateDetail"] |
Vero |
Array JSON di oggetti JSON che elenca dettagli aggiuntivi sullo stato corrente, incluso il motivo per cui è stato raggiunto tale stato. Se non sono disponibili dettagli, questo array sarà vuoto. I valori definiti sono:
|
protectionState |
stringa |
Vero |
Stringa JSON contenente un valore che indica lo stato di protezione dell'applicazione. I valori definiti sono:
|
protectionStateDetails |
vettore["type_astra_stateDetail"] |
Vero |
Array JSON di oggetti JSON che elenca dettagli aggiuntivi sullo stato di protezione corrente, incluso il motivo per cui è stato raggiunto tale stato. Se non sono disponibili dettagli, questo array sarà vuoto. I valori definiti sono:
|
appDetectedType |
stringa |
Falso |
Stringa JSON che rappresenta in modo univoco il tipo specifico di applicazione rilevata. I valori definiti sono:
|
spazi dei nomi |
array[string] |
Vero |
Array JSON di stringhe JSON contenenti i nomi degli spazi dei nomi in cui è in esecuzione l'applicazione. I valori definiti sono:
|
namespaceMapping |
vettore["namespaceMapping"] |
Falso |
Array JSON di oggetti JSON, ciascuno dei quali mappa uno spazio dei nomi di origine a uno spazio dei nomi di destinazione per un'operazione di clonazione. I valori definiti sono:
|
storageClassMapping |
vettore["storageClassMapping"] |
Falso |
Array JSON di oggetti JSON, ognuno dei quali mappa una classe di archiviazione di origine a una classe di archiviazione di destinazione per un'operazione di ripristino. Se non sono presenti elementi o se questi non sono presenti, verranno utilizzati i nomi originali delle classi di archiviazione di origine. I valori definiti sono:
|
clusterName |
stringa |
Falso |
Stringa JSON contenente il nome del cluster su cui è in esecuzione l'applicazione. Non viene restituita se l'applicazione non è attualmente in esecuzione. |
clusterID |
stringa |
Falso |
Stringa JSON contenente l'ID del cluster su cui è in esecuzione l'applicazione. Non viene restituita se l'applicazione non è attualmente in esecuzione. Se specificato in fase di creazione, clusterID indica in quale cluster l'applicazione deve essere clonata. Se il cluster specificato non esiste, o se il cluster specificato non corrisponde al clusterID specificato nell'URI della richiesta, la clonazione non riuscirà. I valori definiti sono:
|
clusterType |
stringa |
Falso |
Stringa JSON contenente un valore che indica il tipo di cluster. I valori definiti sono:
|
ID applicazione sorgente |
stringa |
Falso |
Stringa JSON contenente l'ID di un'applicazione di origine. Viene restituita solo se l'applicazione è stata clonata da un'altra applicazione o è stata ripristinata da un backup o uno snapshot. Quando specificato in fase di creazione, il sourceAppID viene utilizzato insieme al sourceClusterID e indica quale applicazione in esecuzione verrà clonata. Se l'applicazione specificata non esiste sul cluster di origine, la clonazione non riuscirà. È possibile specificare solo uno tra sourceAppID, backupID o snapshotID durante la creazione di un'applicazione. I valori definiti sono:
|
sourceClusterName |
stringa |
Falso |
Stringa JSON contenente il nome del cluster su cui l'applicazione era precedentemente in esecuzione. Restituita solo se l'applicazione è stata clonata da un altro cluster. |
sourceClusterID |
stringa |
Falso |
Stringa JSON contenente l'ID del cluster su cui l'applicazione era precedentemente in esecuzione. Restituita solo se l'applicazione è stata clonata da un altro cluster. Quando specificato in fase di creazione, il sourceClusterID viene utilizzato insieme al sourceAppID e indica il cluster di origine dell'applicazione da clonare. Se il cluster di origine specificato non esiste, la clonazione non andrà a buon fine. I valori definiti sono:
|
backupID |
stringa |
Falso |
Stringa JSON contenente l'ID del backup da cui è stata ripristinata l'applicazione. Restituita solo se l'applicazione è stata ripristinata da un backup. Se specificato in fase di creazione, backupID indica che un'applicazione verrà clonata da un backup esistente. Se il backup specificato non esiste, la clonazione non andrà a buon fine. È possibile specificare solo uno tra sourceAppID, backupID o snapshotID durante la creazione di un'applicazione. Se specificato in fase di sostituzione, backupID indica il backup dell'applicazione da cui verrà ripristinata l'applicazione sul posto. Se il backup specificato non esiste, il ripristino non andrà a buon fine. È possibile specificare solo uno tra backupID o snapshotID durante l'aggiornamento di un'applicazione. I valori definiti sono:
|
snapshotID |
stringa |
Falso |
Stringa JSON contenente l'ID dello snapshot da cui è stata ripristinata l'applicazione. Restituita solo se l'applicazione è stata ripristinata da uno snapshot. Se specificato in fase di creazione, snapshotID indica che un'applicazione verrà clonata da uno snapshot esistente. Se lo snapshot specificato non esiste, la clonazione non andrà a buon fine. È possibile specificare solo uno tra sourceAppID, backupID o snapshotID durante la creazione di un'applicazione. Se specificato in fase di sostituzione, snapshotID indica lo snapshot dell'applicazione da cui verrà ripristinata l'applicazione sul posto. Se lo snapshot specificato non esiste, il ripristino non andrà a buon fine. È possibile specificare solo uno tra backupID o snapshotID durante l'aggiornamento di un'applicazione. I valori definiti sono:
|
replicationSourceAppID |
stringa |
Falso |
Stringa JSON contenente l'ID dell'applicazione che viene replicata in questa applicazione. Viene restituita solo se l'applicazione è attualmente la destinazione in una relazione AppMirror e la relazione non è nello stato failedOver. Quando la relazione è nello stato failedOver, questo campo non viene restituito. I valori definiti sono:
|
restoreFilter |
Falso |
Oggetto JSON contenente un elenco di filtri che descrivono quali risorse sono incluse o escluse da un'operazione di ripristino selettivo. Includi ed escludi si escludono a vicenda e un ripristino selettivo può utilizzare un solo tipo di filtro. |
|
metadati |
Vero |
Metadati specificati dal client e dal servizio associati alla risorsa. I valori definiti sono:
|
Risposta tipo
{
"type": "application/astra-app",
"version": "2.2",
"id": "39c1c79f-efab-5357-88fb-20e628c4dd96",
"links": [],
"name": "jenkins",
"namespaceScopedResources": [
{
"namespace": "production",
"labelSelectors": []
}
],
"state": "pending",
"stateDetails": [],
"protectionState": "none",
"protectionStateDetails": [],
"namespaces": [
"production"
],
"clusterName": "GKE-22",
"clusterID": "0f284377-e5dc-4dcd-bacd-3197f2b8a347",
"clusterType": "kubernetes",
"metadata": {
"labels": [],
"creationTimestamp": "2022-10-06T20:58:16.305662Z",
"modificationTimestamp": "2022-10-06T20:58:16.305662Z",
"createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
}
}
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 |
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/2",
"title": "Collection not found",
"detail": "The collection specified in the request URI wasn't found.",
"status": "404"
}
Definizioni
Vedi definizioni
GVK
Oggetto JSON contenente un gruppo/versione/tipo di Kubernetes.
-
Questo oggetto viene convalidato internamente rispetto ad Astra/apiResources.
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
gruppo |
stringa |
Vero |
Stringa JSON contenente un identificatore di gruppo assegnato da Kubernetes.
|
Tipo |
stringa |
Vero |
Stringa JSON contenente un identificatore di tipo assegnato da Kubernetes.
|
versione |
stringa |
Vero |
Stringa JSON contenente un identificatore di versione assegnato da Kubernetes.
|
clusterScopedResources
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
GVK |
Vero |
Oggetto JSON contenente un gruppo/versione/tipo di Kubernetes.
|
|
labelSelectors |
array[string] |
Falso |
Array JSON di stringhe JSON che rappresentano un selettore di etichette per le GroupVersionKinds (GVK) a livello di cluster all'interno del cluster. Se questo è vuoto, allora tutte le istanze GVK presenti nel cluster sono incluse. Ogni elemento di questo array è una stringa di selettore di etichette Kubernetes e segue la stessa grammatica per tali valori. Esempi:
|
namespaceScopedResources
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
spazio dei nomi |
stringa |
Vero |
Stringa JSON contenente il nome di un namespace in cui è definita l'applicazione. I valori definiti sono:
|
labelSelectors |
array[string] |
Falso |
Array JSON di stringhe JSON che rappresentano un selettore di etichette all'interno del namespace. Se vuoto, vengono incluse tutte le risorse del namespace. Ogni elemento di questo array è una stringa di selettore di etichette Kubernetes e segue la grammatica per tali valori. Esempi:
|
namespaceMapping
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
fonte |
stringa |
Vero |
Stringa JSON contenente il nome del namespace sul cluster di origine. I valori definiti sono:
|
destinazione |
stringa |
Vero |
Stringa JSON contenente il nome del namespace sul cluster di destinazione. I valori definiti sono:
|
storageClassMapping
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
fonte |
stringa |
Vero |
Stringa JSON contenente il nome della classe di archiviazione di origine. Può anche essere '*' per specificare tutte le classi di archiviazione di origine. I valori definiti sono:
|
destinazione |
stringa |
Vero |
Stringa JSON contenente il nome della classe di archiviazione di destinazione. I valori definiti sono:
|
GVKN
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
gruppo |
stringa |
Falso |
Stringa JSON contenente un identificatore di gruppo assegnato da Kubernetes.
|
versione |
stringa |
Falso |
Stringa JSON contenente un identificatore di versione assegnato da Kubernetes.
|
Tipo |
stringa |
Falso |
Stringa JSON contenente un identificatore di tipo assegnato da Kubernetes.
|
spazi dei nomi |
array[string] |
Falso |
Array JSON di stringhe JSON che descrivono i namespace da includere o escludere dalle risorse. I valori definiti sono:
|
nomi |
array[string] |
Falso |
Array JSON di stringhe JSON che descrivono i nomi delle risorse Kubernetes da includere o escludere dal ripristino selettivo. I valori definiti sono:
|
labelSelectors |
array[string] |
Falso |
Array JSON di stringhe JSON che descrivono i selettori di etichette Kubernetes utilizzati per includere o escludere risorse dal ripristino selettivo. Ogni elemento di questo array è una stringa di selettore di etichette Kubernetes e segue la stessa grammatica per tali valori. Esempi:
|
restoreFilter
Oggetto JSON contenente un elenco di filtri che descrivono quali risorse sono incluse o escluse da un'operazione di ripristino selettivo. Includi ed escludi si escludono a vicenda e un ripristino selettivo può utilizzare un solo tipo di filtro.
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
resourceSelectionCriteria |
stringa |
Vero |
Stringa JSON contenente un valore che indica come i filtri delle risorse selezionano le risorse. I valori validi sono include o exclude. |
GVKN |
vettore["GVKN"] |
Vero |
Array JSON di oggetti JSON che descrivono le risorse da filtrare durante un ripristino selettivo. Una risorsa corrisponde a un singolo elemento filtro GVKN se tutti i campi filtro specificati corrispondono al campo risorsa corrispondente. I campi filtro che sono array (ad esempio, namespaces e nomi) corrispondono se almeno uno dei loro elementi corrisponde al campo risorsa corrispondente. Il campo labelSelectors richiede che tutti i selettori corrispondano. Una risorsa che corrisponde a qualsiasi filtro nell'array di oggetti filtro GVKN viene inclusa o esclusa dal ripristino in base al valore resourceSelectionCriteria. Specificare oggetti GVKN vuoti comporta un errore di convalida. |
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 di 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 |
targetSchema
accept-post
accetta-put
suggerimenti
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
stato |
stringa |
Falso |
|
permettere |
array[string] |
Falso |
|
accept-post |
Falso |
||
autorizzazioni |
array[string] |
Falso |
|
accetta-put |
Falso |
type_astra_link
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
rel |
stringa |
Vero |
|
href |
stringa |
Vero |
|
tipo |
stringa |
Falso |
|
targetSchema |
Falso |
||
titolo |
stringa |
Falso |
|
suggerimenti |
Falso |
namespaceScopedResources
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
spazio dei nomi |
stringa |
Vero |
Stringa JSON contenente il nome di un namespace in cui è definita l'applicazione. I valori definiti sono:
|
labelSelectors |
array[string] |
Vero |
Array JSON di stringhe JSON che rappresentano un selettore di etichette all'interno del namespace. Se vuoto, vengono incluse tutte le risorse del namespace. Ogni elemento di questo array è una stringa di selettore di etichette Kubernetes e segue la grammatica per tali valori. Esempi:
|
tipo_transizione_stato_astra
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
da |
stringa |
Vero |
|
a |
array[string] |
Vero |
type_astra_stateDetail
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
tipo |
stringa |
Vero |
|
titolo |
stringa |
Vero |
|
dettaglio |
stringa |
Vero |
restoreFilter
Oggetto JSON contenente un elenco di filtri che descrivono quali risorse sono incluse o escluse da un'operazione di ripristino selettivo. Includi ed escludi si escludono a vicenda e un ripristino selettivo può utilizzare un solo tipo di filtro.
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
resourceSelectionCriteria |
stringa |
Falso |
Stringa JSON contenente un valore che indica come i filtri delle risorse selezionano le risorse. I valori validi sono include o exclude. |
GVKN |
vettore["GVKN"] |
Falso |
Array JSON di oggetti JSON che descrivono le risorse da filtrare durante un ripristino selettivo. Una risorsa corrisponde a un singolo elemento filtro GVKN se tutti i campi filtro specificati corrispondono al campo risorsa corrispondente. I campi filtro che sono array (ad esempio, namespaces e nomi) corrispondono se almeno uno dei loro elementi corrisponde al campo risorsa corrispondente. Il campo labelSelectors richiede che tutti i selettori corrispondano. Una risorsa che corrisponde a qualsiasi filtro nell'array di oggetti filtro GVKN viene inclusa o esclusa dal ripristino in base al valore resourceSelectionCriteria. Specificare oggetti GVKN vuoti comporta un errore di convalida. |
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 |