Llama a un proveedor de tipos en una configuración

En esta página se describe cómo utilizar un proveedor de tipos que creaste con Deployment Manager. No se describe cómo crear un proveedor de tipos. Para aprender cómo crear un proveedor de tipos, lee Crear un proveedor de tipos.

Antes de comenzar

Acceder a los proveedores de tipos

Los proveedores de tipos son un recurso por proyecto y son accesibles de acuerdo con los permisos descritos en la documentación de Control de acceso. Es decir:

  • Los editores y lectores de proyectos pueden crear y utilizar los tipos disponibles para ese proyecto.
  • Los lectores de tipos pueden obtener una lista de los tipos disponibles para ese proyecto y pueden utilizar tales tipos disponibles.

Además, puedes agregar otro proyecto como lector de tipo para que pueda acceder a tus tipos. Lee Compartir tipos en todos los proyectos.

Utilizar un proveedor de tipos

Para utilizar un tipo que expone un proveedor de tipos en la configuración, utiliza la siguiente sintaxis:

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

  • Si está API está respaldada por una especificación de OpenAPI, [COLLECTION] sería el identificador de REST para la ruta al recurso. Por ejemplo:

    type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people

  • Si la API está respaldada por un Documento de Google Discovery, [COLLECTION] es la ruta de los recursos que conducen al recurso deseado en la API. Por ejemplo, para crear una clave de cuenta de servicio, la colección sería la siguiente:

    type: my-project/example-type-provider:projects.serviceAccounts.keys

Ahora continúa la configuración del tipo como lo requiere la API subyacente:

resources:
- name: Jane
  type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
  properties:
  - displayName: Jane
    email: jane@example.com
    ...

Pasos siguientes