Typanbieter in einer Konfiguration aufrufen

Auf dieser Seite wird erläutert, wie Sie einen Typanbieter verwenden, den Sie mit Deployment Manager erstellt haben. Es wird nicht beschrieben, wie ein Typanbieter erstellt wird. Weitere Informationen zur Erstellung eines Typanbieters finden Sie unter Typanbieter erstellen.

Vorbereitung

  • Wenn Sie die Befehlszeilenbeispiele in dieser Anleitung verwenden möchten, installieren Sie das gcloud-Befehlszeilentool.
  • Wenn Sie die API-Beispiele in dieser Anleitung verwenden möchten, richten Sie den API-Zugriff ein.

Auf Typanbieter zugreifen

Typanbieter sind Ressourcen auf Projektbasis und gemäß den Berechtigungen zugänglich, die in der Dokumentation zur Zugriffssteuerung beschrieben sind. Das bedeutet:

  • Projektbearbeiter und -betrachter können für dieses Projekt verfügbare Typen erstellen und verwenden.
  • Typbetrachter können eine Liste von Typen abrufen und die Typen verwenden, die für dieses Projekt verfügbar sind.

Als Typbetrachter können Sie auch ein weiteres Projekt hinzufügen, sodass dieses auf Ihre Typen zugreifen kann. Weitere Informationen finden Sie unter Typen für andere Projekte freigeben.

Typanbieter verwenden

Wenn Sie einen Typ verwenden möchten, der von einem Typanbieter in Ihrer Konfiguration angezeigt wird, verwenden Sie die folgende Syntax:

type: [PROJECT_ID]/[TYPE_NAME]:[COLLECTION]
  • Wenn der API eine OpenAPI-Spezifikation zugeordnet ist, ist [COLLECTION] der REST-Bezeichner für den Pfad zur Ressource. Beispiel:

    type: my-project/emailAddressesTypeProvider:emailAddresses/v1beta/people
    
  • Wenn der API ein Google Discovery-Dokument zugeordnet ist, ist [COLLECTION] der Ressourcenpfad, der zur gewünschten Ressource in der API führt. Beispielsweise lautet die Sammlung zum Erstellen eines Dienstkontoschlüssels:

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

Setzen Sie nun die Konfiguration Ihres Typs fort, wie es die zugrunde liegende API erfordert:

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

Weitere Informationen

Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...

Cloud Deployment Manager-Dokumentation