Chamar um fornecedor de tipos numa configuração

Esta página descreve como usar um fornecedor de tipos que criou com o Deployment Manager. Não descreve como criar um fornecedor de tipos. Para saber como criar um fornecedor de tipos, leia o artigo Criar um fornecedor de tipos.

Antes de começar

Aceder a fornecedores de tipos

Os fornecedores de tipos são um recurso por projeto e são acessíveis de acordo com as autorizações descritas na documentação de controlo de acesso. Ou seja:

  • Os editores e os visitantes do projeto podem criar e usar tipos disponíveis para esse projeto.
  • Os visualizadores de tipo podem obter uma lista e usar os tipos disponíveis para esse projeto.

Também pode adicionar outro projeto como visualizador de tipos para que possa aceder aos seus tipos. Leia o artigo Tipos de partilha entre projetos.

Usar um fornecedor de tipos

Para usar um tipo exposto por um fornecedor de tipos na sua configuração, use a seguinte sintaxe:

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

  • Se esta API for suportada por uma especificação OpenAPI, [COLLECTION] seria o identificador REST para o caminho para o recurso. Por exemplo:

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

  • Se a API for suportada por um documento Google Discovery, [COLLECTION] é o caminho dos recursos que conduzem ao recurso pretendido na API. Por exemplo, para criar uma chave de conta de serviço, a coleção seria:

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

Agora, continue a configurar o seu tipo conforme exigido pela API subjacente:

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

O que se segue?