In questa pagina viene descritto come utilizzare un provider di tipi che hai creato con Deployment Manager. Non descrive come creare un del tipo di provider. Per scoprire come creare un provider dei tipi, consulta Creazione di un provider di tipi.
Prima di iniziare
- Se vuoi utilizzare gli esempi a riga di comando presenti in questa guida, installa lo strumento a riga di comando "gcloud".
- Se vuoi utilizzare gli esempi di API in questa guida, configura l'accesso API.
Accesso ai fornitori di tipi
I provider di tipi sono risorse per singolo progetto e sono accessibili in base al le autorizzazioni descritte nella documentazione sul controllo degli accessi. Ossia:
- Editor e visualizzatori del progetto possono creare e utilizzare i tipi disponibili progetto.
- I visualizzatori dei tipi possono visualizzare un elenco dei tipi disponibili e utilizzarli per il progetto.
Puoi anche aggiungere un altro progetto come visualizzatore dei tipi in modo che possa accedere ai tuoi tipi. Leggi Condivisione dei tipi tra progetti.
Utilizzo di un provider di tipi
Per utilizzare un tipo esposto da un provider dei tipi nella configurazione, usa la seguente sintassi:
type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]
Se questa API è supportata da una specifica OpenAPI,
[COLLECTION]
verrà l'identificatore REST per il percorso della risorsa. Ad esempio:type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
Se l'API è supportata da un documento di Google Discovery,
[COLLECTION]
è il percorso delle risorse che portano alla risorsa desiderata nell'API. Per per creare un'istanza chiave dell'account di servizio, la raccolta sarebbe:type: my-project/example-type-provider:projects.serviceAccounts.keys
Ora continua a configurare il tipo come richiesto dall'API sottostante:
resources:
- name: Jane
type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
properties:
- displayName: Jane
email: jane@example.com
...
Passaggi successivi
- Scopri come creare una configurazione.
- Crea un deployment.
- Scopri come creare un provider dei tipi
- Scopri di più sulle opzioni API avanzate.