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 provider di tipi, leggi Creazione di un provider di tipi.

Prima di iniziare

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

Accedere ai provider di tipi

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

  • Gli editor e i visualizzatori di progetti possono creare e utilizzare i tipi disponibili per il progetto.
  • I visualizzatori di 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.

Utilizzare 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 rilevamento di Google, [COLLECTION] è il percorso delle risorse che portano alla risorsa desiderata 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