Chiamare un provider di tipi in una configurazione

Questa pagina descrive come utilizzare un provider di tipi creato con Deployment Manager. Non descrive come creare un fornitore di tipi. Per scoprire come creare un provider di tipi, consulta Creare un provider di tipi.

Prima di iniziare

Accesso ai provider di tipi

I fornitori di tipi sono una risorsa per progetto e sono accessibili in base alle autorizzazioni descritte nella documentazione di Controllo accesso. Ossia:

  • Gli editor e i visualizzatori del progetto possono creare e utilizzare i tipi disponibili per quel progetto.
  • I visualizzatori di tipo possono ottenere un elenco dei tipi disponibili per il progetto e utilizzarli.

Puoi anche aggiungere un altro progetto come visualizzatore di tipi in modo che possa accedere ai tuoi tipi. Leggi l'articolo Condivisione dei tipi tra progetti.

Utilizzo di un provider di tipi

Per utilizzare un tipo esposto da un provider di tipi nella configurazione, utilizza la seguente sintassi:

type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]

  • Se questa API è supportata da una specifica OpenAPI, [COLLECTION] sarà 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 che ti interessa nell'API. Ad esempio, per creare una chiave dell'account di servizio, la raccolta sarà:

    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