message_buses

Creates, updates, deletes, gets or lists a message_buses resource.

Overview

Name	message_buses
Type	Resource
Id	google.eventarc.message_buses

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}/messageBuses/{message_bus}
annotations	object	Optional. Resource annotations.
createTime	string (google-datetime)	Output only. The creation time.
cryptoKeyName	string	Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern projects/*/locations/*/keyRings/*/cryptoKeys/*.
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.
loggingConfig	object	Optional. Config to control Platform logging for the Message Bus. This log configuration is applied to the Message Bus itself, and all the Enrollments attached to it. (id: LoggingConfig)
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}/messageBuses/{message_bus}
annotations	object	Optional. Resource annotations.
createTime	string (google-datetime)	Output only. The creation time.
cryptoKeyName	string	Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern projects/*/locations/*/keyRings/*/cryptoKeys/*.
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.
loggingConfig	object	Optional. Config to control Platform logging for the Message Bus. This log configuration is applied to the Message Bus itself, and all the Enrollments attached to it. (id: LoggingConfig)
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, messageBusesId		Get a single MessageBus.
list	select	projectsId, locationsId	filter, orderBy, pageSize, pageToken	List message buses.
create	insert	projectsId, locationsId	messageBusId, validateOnly	Create a new MessageBus in a particular project and location.
patch	update	projectsId, locationsId, messageBusesId	allowMissing, updateMask, validateOnly	Update a single message bus.
delete	delete	projectsId, locationsId, messageBusesId	allowMissing, etag, validateOnly	Delete a single message bus.

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

SELECT examples

get

Get a single MessageBus.

SELECT
name,
annotations,
createTime,
cryptoKeyName,
displayName,
etag,
labels,
loggingConfig,
uid,
updateTime
FROM google.eventarc.message_buses
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND messageBusesId = '{{ messageBusesId }}' -- required
;

list

List message buses.

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

INSERT examples

create

Create a new MessageBus in a particular project and location.

INSERT INTO google.eventarc.message_buses (
data__annotations,
data__cryptoKeyName,
data__displayName,
data__labels,
data__loggingConfig,
data__name,
projectsId,
locationsId,
messageBusId,
validateOnly
)
SELECT 
'{{ annotations }}',
'{{ cryptoKeyName }}',
'{{ displayName }}',
'{{ labels }}',
'{{ loggingConfig }}',
'{{ name }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ messageBusId }}',
'{{ validateOnly }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: message_buses
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the message_buses resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the message_buses resource.
  - name: annotations
    value: "{{ annotations }}"
    description: |
      Optional. Resource annotations.
  - name: cryptoKeyName
    value: "{{ cryptoKeyName }}"
    description: |
      Optional. Resource name of a KMS crypto key (managed by the user) used to encrypt/decrypt their event data. It must match the pattern `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
  - name: displayName
    value: "{{ displayName }}"
    description: |
      Optional. Resource display name.
  - name: labels
    value: "{{ labels }}"
    description: |
      Optional. Resource labels.
  - name: loggingConfig
    description: |
      Optional. Config to control Platform logging for the Message Bus. This log configuration is applied to the Message Bus itself, and all the Enrollments attached to it.
    value:
      logSeverity: "{{ logSeverity }}"
  - name: name
    value: "{{ name }}"
    description: |
      Identifier. Resource name of the form projects/{project}/locations/{location}/messageBuses/{message_bus}
  - name: messageBusId
    value: "{{ messageBusId }}"
  - name: validateOnly
    value: {{ validateOnly }}

UPDATE examples

patch

Update a single message bus.

UPDATE google.eventarc.message_buses
SET 
data__annotations = '{{ annotations }}',
data__cryptoKeyName = '{{ cryptoKeyName }}',
data__displayName = '{{ displayName }}',
data__labels = '{{ labels }}',
data__loggingConfig = '{{ loggingConfig }}',
data__name = '{{ name }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND messageBusesId = '{{ messageBusesId }}' --required
AND allowMissing = {{ allowMissing}}
AND updateMask = '{{ updateMask}}'
AND validateOnly = {{ validateOnly}}
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

delete

Delete a single message bus.

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