En esta página se describe cómo usar un proveedor de tipos que haya creado con Deployment Manager. No se describe cómo crear un proveedor de tipos. Para saber cómo crear un proveedor de tipos, consulta el artículo Crear un proveedor de tipos.
Antes de empezar
- Si quieres usar los ejemplos de línea de comandos de esta guía, instala la herramienta de línea de comandos`gcloud`.
- Si quieres usar los ejemplos de API de esta guía, configura el acceso a la API.
Acceder a proveedores de tipos
Los proveedores de tipos son un recurso por proyecto y se puede acceder a ellos según los permisos descritos en la documentación de Control de acceso. Es decir:
- Los editores y lectores de proyectos pueden crear y usar los tipos disponibles en ese proyecto.
- Los usuarios con acceso de lectura pueden obtener una lista de los tipos disponibles en ese proyecto y usarlos.
También puedes añadir otro proyecto como visor de tipos para que pueda acceder a tus tipos. Consulta Compartir tipos entre proyectos.
Usar un proveedor de tipos
Para usar un tipo expuesto por un proveedor de tipos en tu configuración, usa la siguiente sintaxis:
type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]
Si esta API se basa en una especificación de OpenAPI,
[COLLECTION]
sería el identificador REST de la ruta al recurso. Por ejemplo:type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
Si la API se basa en un documento de descubrimiento de Google,
[COLLECTION]
es la ruta de los recursos que lleva al recurso que quieres de 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, sigue configurando el tipo según lo requiera la API subyacente:
resources:
- name: Jane
type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
properties:
- displayName: Jane
email: jane@example.com
...
Siguientes pasos
- Consulta información sobre cómo crear una configuración.
- Crea una implementación.
- Consulta cómo crear un proveedor de tipos.
- Consulta más información sobre las opciones avanzadas de la API.