enrollments

Creates, updates, deletes, gets or lists an enrollments resource.

Overview

Name	enrollments
Type	Resource
Id	google.eventarc.enrollments

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Identifier. Resource name of the form projects/{project}/locations/{location}/enrollments/{enrollment}
annotations	object	Optional. Resource annotations.
celMatch	string	Required. A CEL expression identifying which messages this enrollment applies to.
createTime	string (google-datetime)	Output only. The creation time.
destination	string	Required. Destination is the Pipeline that the Enrollment is delivering to. It must point to the full resource name of a Pipeline. Format: "projects/{PROJECT_ID}/locations/{region}/pipelines/{PIPELINE_ID)"
displayName	string	Optional. Resource display name.
etag	string	Output only. This checksum is computed by the server based on the value of other fields, and might be sent only on update and delete requests to ensure that the client has an up-to-date value before proceeding.
labels	object	Optional. Resource labels.
messageBus	string	Required. Immutable. Resource name of the message bus identifying the source of the messages. It matches the form projects/{project}/locations/{location}/messageBuses/{messageBus}.
uid	string	Output only. Server assigned unique identifier for the channel. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
updateTime	string (google-datetime)	Output only. The last-modified time.

list

Name	Datatype	Description
name	string	Identifier. Resource name of the form projects/{project}/locations/{location}/enrollments/{enrollment}
annotations	object	Optional. Resource annotations.
celMatch	string	Required. A CEL expression identifying which messages this enrollment applies to.
createTime	string (google-datetime)	Output only. The creation time.
destination	string	Required. Destination is the Pipeline that the Enrollment is delivering to. It must point to the full resource name of a Pipeline. Format: "projects/{PROJECT_ID}/locations/{region}/pipelines/{PIPELINE_ID)"
displayName	string	Optional. Resource display name.
etag	string	Output only. This checksum is computed by the server based on the value of other fields, and might be sent only on update and delete requests to ensure that the client has an up-to-date value before proceeding.
labels	object	Optional. Resource labels.
messageBus	string	Required. Immutable. Resource name of the message bus identifying the source of the messages. It matches the form projects/{project}/locations/{location}/messageBuses/{messageBus}.
uid	string	Output only. Server assigned unique identifier for the channel. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
updateTime	string (google-datetime)	Output only. The last-modified time.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, enrollmentsId		Get a single Enrollment.
list	select	projectsId, locationsId	pageToken, filter, pageSize, orderBy	List Enrollments.
create	insert	projectsId, locationsId	validateOnly, enrollmentId	Create a new Enrollment in a particular project and location.
patch	update	projectsId, locationsId, enrollmentsId	updateMask, validateOnly, allowMissing	Update a single Enrollment.
delete	delete	projectsId, locationsId, enrollmentsId	etag, allowMissing, validateOnly	Delete a single Enrollment.

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
enrollmentsId	string
locationsId	string
projectsId	string
allowMissing	boolean
enrollmentId	string
etag	string
filter	string
orderBy	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)
validateOnly	boolean

SELECT examples

get

Get a single Enrollment.

SELECT
name,
annotations,
celMatch,
createTime,
destination,
displayName,
etag,
labels,
messageBus,
uid,
updateTime
FROM google.eventarc.enrollments
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND enrollmentsId = '{{ enrollmentsId }}' -- required
;

list

List Enrollments.

SELECT
name,
annotations,
celMatch,
createTime,
destination,
displayName,
etag,
labels,
messageBus,
uid,
updateTime
FROM google.eventarc.enrollments
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageToken = '{{ pageToken }}'
AND filter = '{{ filter }}'
AND pageSize = '{{ pageSize }}'
AND orderBy = '{{ orderBy }}'
;

INSERT examples

create

Create a new Enrollment in a particular project and location.

INSERT INTO google.eventarc.enrollments (
data__labels,
data__annotations,
data__destination,
data__celMatch,
data__displayName,
data__name,
data__messageBus,
projectsId,
locationsId,
validateOnly,
enrollmentId
)
SELECT 
'{{ labels }}',
'{{ annotations }}',
'{{ destination }}',
'{{ celMatch }}',
'{{ displayName }}',
'{{ name }}',
'{{ messageBus }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ validateOnly }}',
'{{ enrollmentId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: enrollments
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the enrollments resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the enrollments resource.
  - name: labels
    value: "{{ labels }}"
    description: |
      Optional. Resource labels.
  - name: annotations
    value: "{{ annotations }}"
    description: |
      Optional. Resource annotations.
  - name: destination
    value: "{{ destination }}"
    description: |
      Required. Destination is the Pipeline that the Enrollment is delivering to. It must point to the full resource name of a Pipeline. Format: "projects/{PROJECT_ID}/locations/{region}/pipelines/{PIPELINE_ID)"
  - name: celMatch
    value: "{{ celMatch }}"
    description: |
      Required. A CEL expression identifying which messages this enrollment applies to.
  - name: displayName
    value: "{{ displayName }}"
    description: |
      Optional. Resource display name.
  - name: name
    value: "{{ name }}"
    description: |
      Identifier. Resource name of the form projects/{project}/locations/{location}/enrollments/{enrollment}
  - name: messageBus
    value: "{{ messageBus }}"
    description: |
      Required. Immutable. Resource name of the message bus identifying the source of the messages. It matches the form projects/{project}/locations/{location}/messageBuses/{messageBus}.
  - name: validateOnly
    value: {{ validateOnly }}
  - name: enrollmentId
    value: "{{ enrollmentId }}"

UPDATE examples

patch

Update a single Enrollment.

UPDATE google.eventarc.enrollments
SET 
data__labels = '{{ labels }}',
data__annotations = '{{ annotations }}',
data__destination = '{{ destination }}',
data__celMatch = '{{ celMatch }}',
data__displayName = '{{ displayName }}',
data__name = '{{ name }}',
data__messageBus = '{{ messageBus }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND enrollmentsId = '{{ enrollmentsId }}' --required
AND updateMask = '{{ updateMask}}'
AND validateOnly = {{ validateOnly}}
AND allowMissing = {{ allowMissing}}
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

delete

Delete a single Enrollment.

DELETE FROM google.eventarc.enrollments
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND enrollmentsId = '{{ enrollmentsId }}' --required
AND etag = '{{ etag }}'
AND allowMissing = '{{ allowMissing }}'
AND validateOnly = '{{ validateOnly }}'
;