For a list of methods for this resource, see the end of this page.
Resource representations
A resource type supported by Deployment Manager.
{ "name": string, "base": { "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 } ] } } ] } } ] }, "id": unsigned long, "insertTime": string, "description": string, "selfLink": string, "operation": operations Resource, "labels": [ { "key": string, "value": string } ] }
Property name | Value | Description | Notes |
---|---|---|---|
base |
nested object |
Base Type (configurable service) that backs this Type. | |
base.collectionOverrides[] |
list |
Allows resource handling overrides for specific collections | |
base.collectionOverrides[].collection |
string |
The collection that identifies this resource within its service. | |
base.collectionOverrides[].options |
nested object |
The options to apply to this resource-level override | |
base.collectionOverrides[].options.asyncOptions[] |
list |
Options regarding how to thread async requests. | |
base.collectionOverrides[].options.asyncOptions[].methodMatch |
string |
Method regex where this policy will apply. | |
base.collectionOverrides[].options.asyncOptions[].pollingOptions |
nested object |
Deployment manager will poll instances for this API resource setting a RUNNING state, and blocking until polling conditions tell whether the resource is completed or failed. | |
base.collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[] |
list |
An array of diagnostics to be collected by Deployment Manager, these diagnostics will be displayed to the user. | |
base.collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[].field |
string |
JsonPath expression on the resource that if non empty, indicates that this field needs to be extracted as a diagnostic. | |
base.collectionOverrides[].options.asyncOptions[].pollingOptions.diagnostics[].level |
string |
Level to record this diagnostic. | |
base.collectionOverrides[].options.asyncOptions[].pollingOptions.failCondition |
string |
JsonPath expression that determines if the request failed. | |
base.collectionOverrides[].options.asyncOptions[].pollingOptions.finishCondition |
string |
JsonPath expression that determines if the request is completed. | |
base.collectionOverrides[].options.asyncOptions[].pollingOptions.pollingLink |
string |
JsonPath expression that evaluates to string, it indicates where to poll. | |
base.collectionOverrides[].options.asyncOptions[].pollingOptions.targetLink |
string |
JsonPath expression, after polling is completed, indicates where to fetch the resource. | |
base.collectionOverrides[].options.inputMappings[] |
list |
The mappings that apply for requests. | |
base.collectionOverrides[].options.inputMappings[].fieldName |
string |
The name of the field that is going to be injected. | |
base.collectionOverrides[].options.inputMappings[].location |
string |
The location where this mapping applies. | |
base.collectionOverrides[].options.inputMappings[].methodMatch |
string |
Regex to evaluate on method to decide if input applies. | |
base.collectionOverrides[].options.inputMappings[].value |
string |
A jsonPath expression to select an element. | |
base.collectionOverrides[].options.validationOptions |
nested object |
Options for how to validate and process properties on a resource. | |
base.collectionOverrides[].options.validationOptions.schemaValidation |
string |
Customize how deployment manager will validate the resource against schema errors. | |
base.collectionOverrides[].options.validationOptions.undeclaredProperties |
string |
Specify what to do with extra properties when executing a request. | |
base.collectionOverrides[].options.virtualProperties |
string |
Additional properties block described as a jsonSchema, these properties will never be part of the json payload, but they can be consumed by InputMappings, this must be a valid json schema draft-04. The properties specified here will be decouple in a different section. This schema will be merged to the schema validation, and properties here will be extracted From the payload and consumed explicitly by InputMappings. ex: field1: type: string field2: type: number | |
base.credential |
nested object |
Credential used when interacting with this type. | |
base.credential.basicAuth |
nested object |
Basic Auth Credential, only used by TypeProvider. | |
base.credential.basicAuth.password |
string |
||
base.credential.basicAuth.user |
string |
||
base.credential.serviceAccount |
nested object |
Service Account Credential, only used by Deployment. | |
base.credential.serviceAccount.email |
string |
The IAM service account email address like test@myproject.iam.gserviceaccount.com | |
base.credential.useProjectDefault |
boolean |
Specify to use the project default credential, only supported by Deployment. | |
base.descriptorUrl |
string |
Descriptor Url for the this type. | |
base.options |
nested object |
Options to apply when handling any resources in this service. | |
base.options.asyncOptions[] |
list |
Options regarding how to thread async requests. | |
base.options.asyncOptions[].methodMatch |
string |
Method regex where this policy will apply. | |
base.options.asyncOptions[].pollingOptions |
nested object |
Deployment manager will poll instances for this API resource setting a RUNNING state, and blocking until polling conditions tell whether the resource is completed or failed. | |
base.options.asyncOptions[].pollingOptions.diagnostics[] |
list |
An array of diagnostics to be collected by Deployment Manager, these diagnostics will be displayed to the user. | |
base.options.asyncOptions[].pollingOptions.diagnostics[].field |
string |
JsonPath expression on the resource that if non empty, indicates that this field needs to be extracted as a diagnostic. | |
base.options.asyncOptions[].pollingOptions.diagnostics[].level |
string |
Level to record this diagnostic. | |
base.options.asyncOptions[].pollingOptions.failCondition |
string |
JsonPath expression that determines if the request failed. | |
base.options.asyncOptions[].pollingOptions.finishCondition |
string |
JsonPath expression that determines if the request is completed. | |
base.options.asyncOptions[].pollingOptions.pollingLink |
string |
JsonPath expression that evaluates to string, it indicates where to poll. | |
base.options.asyncOptions[].pollingOptions.targetLink |
string |
JsonPath expression, after polling is completed, indicates where to fetch the resource. | |
base.options.inputMappings[] |
list |
The mappings that apply for requests. | |
base.options.inputMappings[].fieldName |
string |
The name of the field that is going to be injected. | |
base.options.inputMappings[].location |
string |
The location where this mapping applies. | |
base.options.inputMappings[].methodMatch |
string |
Regex to evaluate on method to decide if input applies. | |
base.options.inputMappings[].value |
string |
A jsonPath expression to select an element. | |
base.options.validationOptions |
nested object |
Options for how to validate and process properties on a resource. | |
base.options.validationOptions.schemaValidation |
string |
Customize how deployment manager will validate the resource against schema errors. | |
base.options.validationOptions.undeclaredProperties |
string |
Specify what to do with extra properties when executing a request. | |
base.options.virtualProperties |
string |
Additional properties block described as a jsonSchema, these properties will never be part of the json payload, but they can be consumed by InputMappings, this must be a valid json schema draft-04. The properties specified here will be decouple in a different section. This schema will be merged to the schema validation, and properties here will be extracted From the payload and consumed explicitly by InputMappings. ex: field1: type: string field2: type: number | |
description |
string |
An optional textual description of the resource; provided by the client when the resource is created. | |
id |
unsigned long |
||
insertTime |
string |
Output only. Creation timestamp in RFC3339 text format. | |
labels[] |
list |
Map of labels; provided by the client when the resource is created or updated. Specifically: Label keys must be between 1 and 63 characters long and must conform to the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?` Label values must be between 0 and 63 characters long and must conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. |
|
labels[].key |
string |
||
labels[].value |
string |
||
name |
string |
Name of the type. | |
operation |
nested object |
Output only. The Operation that most recently ran, or is currently running, on this type. | |
selfLink |
string |
Output only. Server defined URL for the resource. |
Methods
- list
- Lists all resource types for Deployment Manager.