Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.
Ressourcendarstellungen
Ein Typanbieter, der einen servicegestützten Typ beschreibt.
{ "name": string, "id": unsigned long, "insertTime": string, "description": string, "selfLink": string, "operation": operations Resource, "labels": [ { "key": string, "value": string } ], "descriptorUrl": string, "credential": { "basicAuth": { "user": string, "password": string }, "serviceAccount": { "email": string }, "useProjectDefault": boolean }, "options": { "inputMappings": [ { "fieldName": string, "methodMatch": string, "value": string, "location": string } ], "validationOptions": { "undeclaredProperties": string, "schemaValidation": string }, "virtualProperties": string, "asyncOptions": [ { "methodMatch": string, "pollingOptions": { "finishCondition": string, "failCondition": string, "targetLink": string, "pollingLink": string, "diagnostics": [ { "field": string, "level": string } ] } } ] }, "collectionOverrides": [ { "collection": string, "options": { "inputMappings": [ { "fieldName": string, "methodMatch": string, "value": string, "location": string } ], "validationOptions": { "undeclaredProperties": string, "schemaValidation": string }, "virtualProperties": string, "asyncOptions": [ { "methodMatch": string, "pollingOptions": { "finishCondition": string, "failCondition": string, "targetLink": string, "pollingLink": string, "diagnostics": [ { "field": string, "level": string } ] } } ] } } ], "customCertificateAuthorityRoots": [ string ] }
Eigenschaft | Wert | Beschreibung | Hinweise |
---|---|---|---|
collectionOverrides[] |
list |
Ermöglicht Überschreibungen der Ressourcenverwaltung für bestimmte Sammlungen | |
collectionOverrides[].collection |
string |
Die Sammlung, die diese Ressource innerhalb ihres Dienstes identifiziert. | |
collectionOverrides[].options |
nested object |
Die Optionen, die auf diese Überschreibung auf Ressourcenebene angewendet werden sollen | |
collectionOverrides[].options.asyncOptions[] |
list |
Optionen für die Thread-Verarbeitung asynchroner Anfragen. | |
collectionOverrides[].options.asyncOptions[].methodMatch |
string |
Regex für die Methode, auf die diese Richtlinie angewendet werden soll. | |
collectionOverrides[].options.asyncOptions[].pollingOptions |
nested object |
Deployment Manager fragt Instanzen für diese API-Ressource ab, setzt den Status auf „RUNNING“ (LÄUFT) und blockiert, bis die Abfragebedingungen angeben, ob die Ressource abgeschlossen oder fehlgeschlagen ist. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[] |
list |
Eine Reihe von Diagnosen, die von Deployment Manager erfasst werden. Diese Diagnosen werden dem Nutzer angezeigt. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[].field |
string |
JSONPath-Ausdruck für die Ressource, der angibt, dass dieses Feld als Diagnose extrahiert werden muss. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[].level |
string |
Ebene, auf der diese Diagnose aufgezeichnet werden soll. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.failCondition |
string |
JSONPath-Ausdruck, der bestimmt, ob die Anfrage fehlgeschlagen ist. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.finishCondition |
string |
JSONPath-Ausdruck, der bestimmt, ob die Anfrage abgeschlossen ist. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.pollingLink |
string |
JSONPath-Ausdruck, der zu einem String ausgewertet wird und angibt, wo abgefragt werden soll. | |
collectionOverrides[].options.asyncOptions[].pollingOptions.targetLink |
string |
Der JSONPath-Ausdruck gibt an, wo die Ressource nach Abschluss der Abfrage abgerufen werden soll. | |
collectionOverrides[].options.inputMappings[] |
list |
Die Zuordnungen, die für Anfragen gelten. | |
collectionOverrides[].options.inputMappings[].fieldName |
string |
Der Name des Felds, das eingefügt werden soll. | |
collectionOverrides[].options.inputMappings[].location |
string |
Der Ort, für den diese Zuordnung gilt. | |
collectionOverrides[].options.inputMappings[].methodMatch |
string |
Regex, der anhand der Methode ausgewertet wird, um zu entscheiden, ob die Eingabe zutrifft. | |
collectionOverrides[].options.inputMappings[].value |
string |
Ein JSONPath-Ausdruck zum Auswählen eines Elements. | |
collectionOverrides[].options.validationOptions |
nested object |
Optionen zum Validieren und Verarbeiten von Properties in einer Ressource. | |
collectionOverrides[].options.validationOptions.schemaValidation |
string |
Sie können anpassen, wie Deployment Manager die Ressource auf Schemafehler prüft. | |
collectionOverrides[].options.validationOptions.undeclaredProperties |
string |
Hier legen Sie fest, was mit zusätzlichen Properties bei der Ausführung einer Anfrage geschehen soll. | |
collectionOverrides[].options.virtualProperties |
string |
Block mit zusätzlichen Properties, der als JSON-Schema beschrieben ist. Diese Properties sind nie Teil der JSON-Nutzlast, können aber von InputMappings verwendet werden. Dies muss ein gültiges JSON-Schema vom Typ „draft-04“ sein. Die hier angegebenen Properties werden in einem anderen Abschnitt getrennt. Dieses Schema wird mit der Schemavalidierung zusammengeführt. Die darin enthaltenen Properties werden aus der Nutzlast extrahiert und explizit von InputMappings verwendet. Beispiel: field1: type: string field2: type: number | |
credential |
nested object |
Anmeldedaten, die für die Interaktion mit diesem Typ verwendet werden. | |
credential.basicAuth |
nested object |
Anmeldedaten für die Basisauthentifizierung, die nur vom TypeProvider verwendet werden. | |
credential.basicAuth.password |
string |
||
credential.basicAuth.user |
string |
||
credential.serviceAccount |
nested object |
Anmeldedaten für ein Dienstkonto, die nur von der Bereitstellung verwendet werden. | |
credential.serviceAccount.email |
string |
Die E-Mail-Adresse des IAM-Dienstkontos, z. B. test@myproject.iam.gserviceaccount.com | |
credential.useProjectDefault |
boolean |
Hier können Sie angeben, dass die Standardanmeldedaten des Projekts verwendet werden sollen. Diese werden nur vom Deployment unterstützt. | |
customCertificateAuthorityRoots[] |
list |
Liste von bis zu zwei Stammzertifizierungsstellen, die für die TLS-Authentifizierung bei Aufrufen im Namen dieses Typanbieters verwendet werden sollen. Wenn diese Einstellung festgelegt ist, werden bei der TLS-Authentifizierung ausschließlich diese Stammzertifikate verwendet, anstatt sich bei der Validierung der TLS-Zertifikatsauthentizität auf öffentlich vertrauenswürdige Zertifizierungsstellen zu verlassen. Die Zertifikate müssen im Base64-codierten PEM-Format vorliegen. Die maximale Größe jedes Zertifikats darf 10 KB nicht überschreiten. | |
description |
string |
Eine optionale Textbeschreibung der Ressource; wird vom Client bei der Erstellung der Ressource bereitgestellt. | |
descriptorUrl |
string |
Deskriptor-URL für diesen Typanbieter. | |
id |
unsigned long |
Nur Ausgabe. Die vom Server definierte eindeutige Kennung für die Ressource. | |
insertTime |
string |
Nur Ausgabe. Erstellungszeitstempel im Textformat RFC3339. | |
labels[] |
list |
Zuordnung von Labels; vom Client beim Erstellen oder Aktualisieren der Ressource bereitgestellt. Im Detail: Labelschlüssel müssen zwischen 1 und 63 Zeichen lang sein und dem folgenden regulären Ausdruck entsprechen: `[a-z]([-a-z0-9]*[a-z0-9])?`. Labelwerte müssen zwischen 0 und 63 Zeichen lang sein und dem regulären Ausdruck `([a-z]([-a-z0-9]*[a-z0-9])?)?` entsprechen. |
|
labels[].key |
string |
||
labels[].value |
string |
||
name |
string |
Name der Ressource, angegeben vom Client beim Erstellen der Ressource. Der Name muss zwischen 1 und 63 Zeichen lang sein und RFC 1035 entsprechen. Insbesondere muss der Name 1–63 Zeichen lang sein und mit dem regulären Ausdruck `[a-z]([-a-z0-9]*[a-z0-9])?` übereinstimmen. Das heißt, das erste Zeichen muss ein Kleinbuchstabe und alle folgenden Zeichen müssen aus Bindestrichen, Kleinbuchstaben und Ziffern bestehen. Das letzte Zeichen darf kein Bindestrich sein. | |
operation |
nested object |
Nur Ausgabe. Die Operation, die zuletzt oder derzeit bei diesem Typanbieter ausgeführt wurde. | |
options |
nested object |
Optionen, die beim Umgang mit Ressourcen in diesem Dienst angewendet werden können. | |
options.asyncOptions[] |
list |
Optionen für die Thread-Verarbeitung asynchroner Anfragen. | |
options.asyncOptions[].methodMatch |
string |
Regex für die Methode, auf die diese Richtlinie angewendet werden soll. | |
options.asyncOptions[].pollingOptions |
nested object |
Deployment Manager fragt Instanzen für diese API-Ressource ab, setzt den Status auf „RUNNING“ (LÄUFT) und blockiert, bis die Abfragebedingungen angeben, ob die Ressource abgeschlossen oder fehlgeschlagen ist. | |
options.asyncOptions[].pollingOptions.diagnostics[] |
list |
Eine Reihe von Diagnosen, die von Deployment Manager erfasst werden. Diese Diagnosen werden dem Nutzer angezeigt. | |
options.asyncOptions[].pollingOptions.diagnostics[].field |
string |
JSONPath-Ausdruck für die Ressource, der angibt, dass dieses Feld als Diagnose extrahiert werden muss. | |
options.asyncOptions[].pollingOptions.diagnostics[].level |
string |
Ebene, auf der diese Diagnose aufgezeichnet werden soll. | |
options.asyncOptions[].pollingOptions.failCondition |
string |
JSONPath-Ausdruck, der bestimmt, ob die Anfrage fehlgeschlagen ist. | |
options.asyncOptions[].pollingOptions.finishCondition |
string |
JSONPath-Ausdruck, der bestimmt, ob die Anfrage abgeschlossen ist. | |
options.asyncOptions[].pollingOptions.pollingLink |
string |
JSONPath-Ausdruck, der zu einem String ausgewertet wird und angibt, wo abgefragt werden soll. | |
options.asyncOptions[].pollingOptions.targetLink |
string |
Der JSONPath-Ausdruck gibt an, wo die Ressource nach Abschluss der Abfrage abgerufen werden soll. | |
options.inputMappings[] |
list |
Die Zuordnungen, die für Anfragen gelten. | |
options.inputMappings[].fieldName |
string |
Der Name des Felds, das eingefügt werden soll. | |
options.inputMappings[].location |
string |
Der Ort, für den diese Zuordnung gilt. | |
options.inputMappings[].methodMatch |
string |
Regex, der anhand der Methode ausgewertet wird, um zu entscheiden, ob die Eingabe zutrifft. | |
options.inputMappings[].value |
string |
Ein JSONPath-Ausdruck zum Auswählen eines Elements. | |
options.validationOptions |
nested object |
Optionen zum Validieren und Verarbeiten von Properties in einer Ressource. | |
options.validationOptions.schemaValidation |
string |
Sie können anpassen, wie Deployment Manager die Ressource auf Schemafehler prüft. | |
options.validationOptions.undeclaredProperties |
string |
Hier legen Sie fest, was mit zusätzlichen Properties bei der Ausführung einer Anfrage geschehen soll. | |
options.virtualProperties |
string |
Block mit zusätzlichen Properties, der als JSON-Schema beschrieben ist. Diese Properties sind nie Teil der JSON-Nutzlast, können aber von InputMappings verwendet werden. Dies muss ein gültiges JSON-Schema vom Typ „draft-04“ sein. Die hier angegebenen Properties werden in einem anderen Abschnitt getrennt. Dieses Schema wird mit der Schemavalidierung zusammengeführt. Die darin enthaltenen Properties werden aus der Nutzlast extrahiert und explizit von InputMappings verwendet. Beispiel: field1: type: string field2: type: number | |
selfLink |
string |
Nur Ausgabe. Link zum Typanbieter. |
Methoden
- Delete
- Löscht einen Typanbieter.
- get
- Ruft Informationen zu einem bestimmten Typanbieter ab.
- getType
- Ruft Informationen zu einem Typ ab, der von einem Typanbieter bereitgestellt wird.
- insert
- Erstellt einen Typanbieter.
- list
- Listet alle Ressourcentypanbieter für Deployment Manager auf.
- listTypes
- Listet alle Typinformationen für einen TypeProvider auf.
- patch
- Patcht einen Typanbieter.
- aktualisieren
- Aktualisiert einen Typanbieter.