custom_target_types
Creates, updates, deletes, gets or lists a custom_target_types
resource.
Overview
Name | custom_target_types |
Type | Resource |
Id | google.clouddeploy.custom_target_types |
Fields
The following fields are returned by SELECT
queries:
- get
- list
Successful response
Name | Datatype | Description |
---|---|---|
name | string | Identifier. Name of the CustomTargetType . Format is projects/{project}/locations/{location}/customTargetTypes/{customTargetType} . The customTargetType component must match [a-z]([a-z0-9-]{0,61}[a-z0-9])? |
annotations | object | Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations. |
createTime | string (google-datetime) | Output only. Time at which the CustomTargetType was created. |
customActions | object | Optional. Configures render and deploy for the CustomTargetType using Skaffold custom actions. (id: CustomTargetSkaffoldActions) |
customTargetTypeId | string | Output only. Resource id of the CustomTargetType . |
description | string | Optional. Description of the CustomTargetType . Max length is 255 characters. |
etag | string | Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. |
labels | object | Optional. Labels are attributes that can be set and used by both the user and by Cloud Deploy. Labels must meet the following constraints: * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. * All characters must use UTF-8 encoding, and international characters are allowed. * Keys must start with a lowercase letter or international character. * Each resource is limited to a maximum of 64 labels. Both keys and values are additionally constrained to be <= 128 bytes. |
uid | string | Output only. Unique identifier of the CustomTargetType . |
updateTime | string (google-datetime) | Output only. Most recent time at which the CustomTargetType was updated. |
Successful response
Name | Datatype | Description |
---|---|---|
name | string | Identifier. Name of the CustomTargetType . Format is projects/{project}/locations/{location}/customTargetTypes/{customTargetType} . The customTargetType component must match [a-z]([a-z0-9-]{0,61}[a-z0-9])? |
annotations | object | Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations. |
createTime | string (google-datetime) | Output only. Time at which the CustomTargetType was created. |
customActions | object | Optional. Configures render and deploy for the CustomTargetType using Skaffold custom actions. (id: CustomTargetSkaffoldActions) |
customTargetTypeId | string | Output only. Resource id of the CustomTargetType . |
description | string | Optional. Description of the CustomTargetType . Max length is 255 characters. |
etag | string | Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. |
labels | object | Optional. Labels are attributes that can be set and used by both the user and by Cloud Deploy. Labels must meet the following constraints: * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. * All characters must use UTF-8 encoding, and international characters are allowed. * Keys must start with a lowercase letter or international character. * Each resource is limited to a maximum of 64 labels. Both keys and values are additionally constrained to be <= 128 bytes. |
uid | string | Output only. Unique identifier of the CustomTargetType . |
updateTime | string (google-datetime) | Output only. Most recent time at which the CustomTargetType was updated. |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get | select | projectsId , locationsId , customTargetTypesId | Gets details of a single CustomTargetType. | |
list | select | projectsId , locationsId | pageSize , pageToken , filter , orderBy | Lists CustomTargetTypes in a given project and location. |
create | insert | projectsId , locationsId | customTargetTypeId , requestId , validateOnly | Creates a new CustomTargetType in a given project and location. |
patch | update | projectsId , locationsId , customTargetTypesId | updateMask , requestId , allowMissing , validateOnly | Updates a single CustomTargetType. |
delete | delete | projectsId , locationsId , customTargetTypesId | requestId , allowMissing , validateOnly , etag | Deletes a single CustomTargetType. |
Parameters
Parameters can be passed in the WHERE
clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
Name | Datatype | Description |
---|---|---|
customTargetTypesId | string | |
locationsId | string | |
projectsId | string | |
allowMissing | boolean | |
customTargetTypeId | string | |
etag | string | |
filter | string | |
orderBy | string | |
pageSize | integer (int32) | |
pageToken | string | |
requestId | string | |
updateMask | string (google-fieldmask) | |
validateOnly | boolean |
SELECT
examples
- get
- list
Gets details of a single CustomTargetType.
SELECT
name,
annotations,
createTime,
customActions,
customTargetTypeId,
description,
etag,
labels,
uid,
updateTime
FROM google.clouddeploy.custom_target_types
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND customTargetTypesId = '{{ customTargetTypesId }}' -- required;
Lists CustomTargetTypes in a given project and location.
SELECT
name,
annotations,
createTime,
customActions,
customTargetTypeId,
description,
etag,
labels,
uid,
updateTime
FROM google.clouddeploy.custom_target_types
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}';
INSERT
examples
- create
- Manifest
Creates a new CustomTargetType in a given project and location.
INSERT INTO google.clouddeploy.custom_target_types (
data__name,
data__description,
data__annotations,
data__labels,
data__etag,
data__customActions,
projectsId,
locationsId,
customTargetTypeId,
requestId,
validateOnly
)
SELECT
'{{ name }}',
'{{ description }}',
'{{ annotations }}',
'{{ labels }}',
'{{ etag }}',
'{{ customActions }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ customTargetTypeId }}',
'{{ requestId }}',
'{{ validateOnly }}'
RETURNING
name,
done,
error,
metadata,
response
;
# Description fields are for documentation purposes
- name: custom_target_types
props:
- name: projectsId
value: string
description: Required parameter for the custom_target_types resource.
- name: locationsId
value: string
description: Required parameter for the custom_target_types resource.
- name: name
value: string
description: >
Identifier. Name of the `CustomTargetType`. Format is `projects/{project}/locations/{location}/customTargetTypes/{customTargetType}`. The `customTargetType` component must match `[a-z]([a-z0-9-]{0,61}[a-z0-9])?`
- name: description
value: string
description: >
Optional. Description of the `CustomTargetType`. Max length is 255 characters.
- name: annotations
value: object
description: >
Optional. User annotations. These attributes can only be set and used by the user, and not by Cloud Deploy. See https://google.aip.dev/128#annotations for more details such as format and size limitations.
- name: labels
value: object
description: >
Optional. Labels are attributes that can be set and used by both the user and by Cloud Deploy. Labels must meet the following constraints: * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. * All characters must use UTF-8 encoding, and international characters are allowed. * Keys must start with a lowercase letter or international character. * Each resource is limited to a maximum of 64 labels. Both keys and values are additionally constrained to be <= 128 bytes.
- name: etag
value: string
description: >
Optional. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
- name: customActions
value: object
description: >
Optional. Configures render and deploy for the `CustomTargetType` using Skaffold custom actions.
- name: customTargetTypeId
value: string
- name: requestId
value: string
- name: validateOnly
value: boolean
UPDATE
examples
- patch
Updates a single CustomTargetType.
UPDATE google.clouddeploy.custom_target_types
SET
data__name = '{{ name }}',
data__description = '{{ description }}',
data__annotations = '{{ annotations }}',
data__labels = '{{ labels }}',
data__etag = '{{ etag }}',
data__customActions = '{{ customActions }}'
WHERE
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND customTargetTypesId = '{{ customTargetTypesId }}' --required
AND updateMask = '{{ updateMask}}'
AND requestId = '{{ requestId}}'
AND allowMissing = {{ allowMissing}}
AND validateOnly = {{ validateOnly}}
RETURNING
name,
done,
error,
metadata,
response;
DELETE
examples
- delete
Deletes a single CustomTargetType.
DELETE FROM google.clouddeploy.custom_target_types
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND customTargetTypesId = '{{ customTargetTypesId }}' --required
AND requestId = '{{ requestId }}'
AND allowMissing = '{{ allowMissing }}'
AND validateOnly = '{{ validateOnly }}'
AND etag = '{{ etag }}';