Per un elenco dei metodi per questa risorsa, consulta la fine di questa pagina.
Rappresentazioni delle risorse
Un provider di tipi che descrive un tipo basato su servizio.
{ "name": string, "id": unsigned long, "insertTime": string, "description": string, "selfLink": string, "operation": operations Resource, "labels": [ { "key": string, "value": string } ], "descriptorUrl": string, "credential": { "basicAuth": { "user": string, "password": string }, "serviceAccount": { "email": string }, "useProjectDefault": boolean }, "options": { "inputMappings": [ { "fieldName": string, "methodMatch": string, "value": string, "location": string } ], "validationOptions": { "undeclaredProperties": string, "schemaValidation": string }, "virtualProperties": string, "asyncOptions": [ { "methodMatch": string, "pollingOptions": { "finishCondition": string, "failCondition": string, "targetLink": string, "pollingLink": string, "diagnostics": [ { "field": string, "level": string } ] } } ] }, "collectionOverrides": [ { "collection": string, "options": { "inputMappings": [ { "fieldName": string, "methodMatch": string, "value": string, "location": string } ], "validationOptions": { "undeclaredProperties": string, "schemaValidation": string }, "virtualProperties": string, "asyncOptions": [ { "methodMatch": string, "pollingOptions": { "finishCondition": string, "failCondition": string, "targetLink": string, "pollingLink": string, "diagnostics": [ { "field": string, "level": string } ] } } ] } } ], "customCertificateAuthorityRoots": [ string ] }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
collectionOverrides[] |
list |
Consente l'override della gestione delle risorse per raccolte specifiche | |
collectionOverrides[].collection |
string |
La raccolta che identifica questa risorsa all'interno del servizio. | |
collectionOverrides[].options |
nested object |
Le opzioni da applicare a questa sostituzione a livello di risorsa | |
collectionOverrides[].options.asyncOptions[] |
list |
Opzioni per il threading delle richieste asincrone. | |
collectionOverrides[].options.asyncOptions[].methodMatch |
string |
Espressione regolare del metodo a cui si applica questo criterio. | |
collectionOverrides[].options.asyncOptions[].pollingOptions |
nested object |
Deployment Manager eseguirà il polling delle istanze per questa risorsa API impostando uno stato RUNNING e bloccandosi finché le condizioni di polling non indicano se la risorsa è stata completata o meno. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[] |
list |
Un array di dati diagnostici da raccogliere da Deployment Manager, che verranno mostrati all'utente. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[].field |
string |
Espressione JsonPath nella risorsa che, se non vuota, indica che questo campo deve essere estratto come diagnostica. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[].level |
string |
Livello per registrare questa diagnostica. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.failCondition |
string |
Espressione JsonPath che determina se la richiesta non è riuscita. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.finishCondition |
string |
Espressione JsonPath che determina se la richiesta è completata. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.pollingLink |
string |
Espressione JsonPath che restituisce una stringa e indica dove eseguire il polling. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.targetLink |
string |
L'espressione JsonPath, al termine del polling, indica dove recuperare la risorsa. | |
collectionOverrides[].options.inputMappings[] |
list |
Le mappature che si applicano alle richieste. | |
collectionOverrides[].options.inputMappings[].fieldName |
string |
Il nome del campo da iniettare. | |
collectionOverrides[].options.inputMappings[].location |
string |
La località a cui si applica questa mappatura. | |
collectionOverrides[].options.inputMappings[].methodMatch |
string |
Espressione regolare da valutare nel metodo per decidere se l'input è applicabile. | |
collectionOverrides[].options.inputMappings[].value |
string |
Un'espressione JSONPath per selezionare un elemento. | |
collectionOverrides[].options.validationOptions |
nested object |
Opzioni per convalidare ed elaborare le proprietà in una risorsa. | |
collectionOverrides[].options.validationOptions.schemaValidation |
string |
Personalizza la modalità di convalida della risorsa da parte di Deployment Manager in base agli errori dello schema. | |
collectionOverrides[].options.validationOptions.undeclaredProperties |
string |
Specifica cosa fare con le proprietà aggiuntive durante l'esecuzione di una richiesta. | |
collectionOverrides[].options.virtualProperties |
string |
Blocco di proprietà aggiuntive descritto come jsonSchema. Queste proprietà non faranno mai parte del payload JSON, ma possono essere utilizzate da InputMappings. Deve essere uno schema JSON draft-04 valido. Le proprietà specificate qui verranno disaccoppiate in un'altra sezione. Questo schema verrà unito alla convalida dello schema e le proprietà verranno estratte dal payload e utilizzate esplicitamente da InputMappings. Es: campo1: tipo: stringa campo2: tipo: numero | |
credential |
nested object |
L'autenticazione utilizzata quando si interagisce con questo tipo. | |
credential.basicAuth |
nested object |
Credenziale di autenticazione di base, utilizzata solo da TypeProvider. | |
credential.basicAuth.password |
string |
||
credential.basicAuth.user |
string |
||
credential.serviceAccount |
nested object |
Credenziale dell'account di servizio, utilizzata solo dal deployment. | |
credential.serviceAccount.email |
string |
L'indirizzo email dell'account di servizio IAM, ad esempio test@myproject.iam.gserviceaccount.com | |
credential.useProjectDefault |
boolean |
Specifica di utilizzare le credenziali predefinite del progetto, supportate solo dal deployment. | |
customCertificateAuthorityRoots[] |
list |
Elenco di massimo due autorità di certificazione principali personalizzate da utilizzare per l'autenticazione TLS quando effettui chiamate per conto di questo tipo di provider. Se impostato, l'autenticazione TLS utilizzerà esclusivamente queste radici anziché fare affidamento su autorità di certificazione attendibili pubblicamente per convalidare l'autenticità del certificato TLS. I certificati devono essere in formato PEM con codifica base64. La dimensione massima di ciascun certificato non deve superare i 10 KB. | |
description |
string |
Una descrizione testuale facoltativa della risorsa, fornita dal cliente al momento della creazione della risorsa. | |
descriptorUrl |
string |
URL del descrittore per questo tipo di fornitore. | |
id |
unsigned long |
Solo output. Identificatore univoco della risorsa definita dal server. | |
insertTime |
string |
Solo output. Timestamp di creazione in formato di testo RFC3339. | |
labels[] |
list |
Mappa di etichette fornite dal client quando la risorsa viene creata o aggiornata. Nello specifico: le chiavi delle etichette devono avere una lunghezza compresa tra 1 e 63 caratteri e devono essere conformi alla seguente espressione regolare: `[a-z]([-a-z0-9]*[a-z0-9])?` I valori delle etichette devono avere una lunghezza compresa tra 0 e 63 caratteri e devono essere conformi all'espressione regolare `([a-z]([-a-z0-9]*[a-z0-9])?)?`. |
|
labels[].key |
string |
||
labels[].value |
string |
||
name |
string |
Nome della risorsa, fornito dal cliente al momento della creazione. Il nome deve avere una lunghezza compresa tra 1 e 63 caratteri ed essere conforme allo standard RFC1035. Nello specifico, il nome deve avere una lunghezza compresa tra 1 e 63 caratteri e corrispondere all'espressione regolare `[a-z]([-a-z0-9]*[a-z0-9])?`, il che significa che il primo carattere deve essere una lettera minuscola e tutti i caratteri successivi devono essere trattini, lettere minuscole o cifre, tranne l'ultimo carattere, che non può essere un trattino. | |
operation |
nested object |
Solo output. L'operazione eseguita più di recente o in esecuzione su questo tipo di provider. | |
options |
nested object |
Opzioni da applicare durante la gestione delle risorse di questo servizio. | |
options.asyncOptions[] |
list |
Opzioni per il threading delle richieste asincrone. | |
options.asyncOptions[].methodMatch |
string |
Espressione regolare del metodo a cui si applica questo criterio. | |
options.asyncOptions[].pollingOptions |
nested object |
Deployment Manager eseguirà il polling delle istanze per questa risorsa API impostando uno stato RUNNING e bloccandosi finché le condizioni di polling non indicano se la risorsa è stata completata o meno. | |
options.asyncOptions[].pollingOptions.diagnostics[] |
list |
Un array di dati diagnostici da raccogliere da Deployment Manager, che verranno mostrati all'utente. | |
options.asyncOptions[].pollingOptions.diagnostics[].field |
string |
Espressione JsonPath nella risorsa che, se non vuota, indica che questo campo deve essere estratto come diagnostica. | |
options.asyncOptions[].pollingOptions.diagnostics[].level |
string |
Livello per registrare questa diagnostica. | |
options.asyncOptions[].pollingOptions.failCondition |
string |
Espressione JsonPath che determina se la richiesta non è riuscita. | |
options.asyncOptions[].pollingOptions.finishCondition |
string |
Espressione JsonPath che determina se la richiesta è completata. | |
options.asyncOptions[].pollingOptions.pollingLink |
string |
Espressione JsonPath che restituisce una stringa e indica dove eseguire il polling. | |
options.asyncOptions[].pollingOptions.targetLink |
string |
L'espressione JsonPath, al termine del polling, indica dove recuperare la risorsa. | |
options.inputMappings[] |
list |
Le mappature che si applicano alle richieste. | |
options.inputMappings[].fieldName |
string |
Il nome del campo da iniettare. | |
options.inputMappings[].location |
string |
La località a cui si applica questa mappatura. | |
options.inputMappings[].methodMatch |
string |
Espressione regolare da valutare nel metodo per decidere se l'input è applicabile. | |
options.inputMappings[].value |
string |
Un'espressione JSONPath per selezionare un elemento. | |
options.validationOptions |
nested object |
Opzioni per convalidare ed elaborare le proprietà in una risorsa. | |
options.validationOptions.schemaValidation |
string |
Personalizza la modalità di convalida della risorsa da parte di Deployment Manager in base agli errori dello schema. | |
options.validationOptions.undeclaredProperties |
string |
Specifica cosa fare con le proprietà aggiuntive durante l'esecuzione di una richiesta. | |
options.virtualProperties |
string |
Blocco di proprietà aggiuntive descritto come jsonSchema. Queste proprietà non faranno mai parte del payload JSON, ma possono essere utilizzate da InputMappings. Deve essere uno schema JSON draft-04 valido. Le proprietà specificate qui verranno disaccoppiate in un'altra sezione. Questo schema verrà unito alla convalida dello schema e le proprietà verranno estratte dal payload e utilizzate esplicitamente da InputMappings. Es: campo1: tipo: stringa campo2: tipo: numero | |
selfLink |
string |
Solo output. Link autoreferenziale per il provider di tipo. |
Metodi
- elimina
- Elimina un provider di tipi.
- get
- Ottiene informazioni su un fornitore di tipo specifico.
- getType
- Ottiene le informazioni su un tipo per un tipo fornito da un TypeProvider.
- inserire
- Crea un provider di tipi.
- list
- Elenca tutti i fornitori di tipi di risorse per Deployment Manager.
- listTypes
- Elenca tutte le informazioni sul tipo per un TypeProvider.
- patch
- Esegue il patching di un provider di tipi.
- update
- Aggiorna un provider di tipi.