Chiamata a un provider dei 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 informazioni su come creare un provider di tipi, consulta Creazione di un provider dei tipi.

Prima di iniziare

Se vuoi utilizzare gli esempi a riga di comando di questa guida, installa lo strumento a riga di comando "gcloud".
Se vuoi utilizzare gli esempi di API descritti in questa guida, configura l'accesso alle API.

Accesso ai provider di tipi

I provider di tipi sono una risorsa specifica per progetto e sono accessibili in base alle autorizzazioni descritte nella documentazione relativa al controllo degli accessi. Ossia:

Gli editor e i visualizzatori del progetto possono creare e utilizzare i tipi disponibili per il progetto.
I visualizzatori dei tipi possono visualizzare un elenco dei tipi disponibili per il progetto e utilizzarli.

Puoi anche aggiungere un altro progetto come visualizzatore dei 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 tua 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 Google Discovery, [COLLECTION] è il percorso delle risorse che porta alla risorsa desiderata nell'API. Ad esempio, per creare una 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 di tipi
Scopri di più sulle opzioni avanzate dell'API.