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 provider di tipi. Per scoprire come creare un fornitore di tipi, leggi Creazione di un fornitore di tipi.

Prima di iniziare

Accesso ai provider di tipi

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

  • Gli editor e i visualizzatori del progetto possono creare e utilizzare i tipi disponibili per quel progetto.
  • Gli spettatori dei tipi 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 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] sarebbe 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 rilevamento di Google, [COLLECTION] è il percorso delle risorse che porta alla risorsa desiderata nell'API. Ad esempio, per creare una chiave del service account, 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