transit_gateway_attachments
Creates, updates, deletes, gets or lists a transit_gateway_attachments resource.
Overview
| Name | transit_gateway_attachments |
| Type | Resource |
| Id | confluent.networking.transit_gateway_attachments |
Fields
The following fields are returned by SELECT queries:
- get_networking_v1_transit_gateway_attachment
- list_networking_v1_transit_gateway_attachments
Transit Gateway Attachment.
| Name | Datatype | Description |
|---|---|---|
id | string | ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object kinds or objects of the same kind within a different scope/namespace ("space"). (example: dlz-f3a90de) |
api_version | string | APIVersion defines the schema version of this representation of a resource. (networking/v1) |
kind | string | Kind defines the object this REST resource represents. (TransitGatewayAttachment) |
metadata | object | ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. |
spec | object | The desired state of the Transit Gateway Attachment |
status | object | The status of the Transit Gateway Attachment |
Transit Gateway Attachment.
| Name | Datatype | Description |
|---|---|---|
id | string | ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object kinds or objects of the same kind within a different scope/namespace ("space"). (example: dlz-f3a90de) |
api_version | string | APIVersion defines the schema version of this representation of a resource. (networking/v1) |
kind | string | Kind defines the object this REST resource represents. (TransitGatewayAttachment) |
metadata | object | ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create. |
spec | object | The desired state of the Transit Gateway Attachment |
status | object | The status of the Transit Gateway Attachment |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_networking_v1_transit_gateway_attachment | select | environment, id | Make a request to read a transit gateway attachment. | |
list_networking_v1_transit_gateway_attachments | select | environment | spec.display_name, status.phase, spec.network, page_size, page_token | Retrieve a sorted, filtered, paginated list of all transit gateway attachments. |
create_networking_v1_transit_gateway_attachment | insert | spec | Make a request to create a transit gateway attachment. | |
update_networking_v1_transit_gateway_attachment | update | id, spec | Make a request to update a transit gateway attachment. | |
delete_networking_v1_transit_gateway_attachment | delete | environment, id | Make a request to delete a transit gateway attachment. |
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 |
|---|---|---|
environment | string | Scope the operation to the given environment. (example: env-00000) |
id | string | The unique identifier for the transit gateway attachment. |
page_size | integer | A pagination size for collection requests. |
page_token | string | An opaque pagination token for collection requests. |
spec.display_name | array | Filter the results by exact match for spec.display_name. Pass multiple times to see results matching any of the values. (example: [prod-tgw-use1, prod-tgw-usw2]) |
spec.network | array | Filter the results by exact match for spec.network. Pass multiple times to see results matching any of the values. (example: [n-00000, n-00001]) |
status.phase | array | Filter the results by exact match for status.phase. Pass multiple times to see results matching any of the values. (example: [PROVISIONING, READY]) |
SELECT examples
- get_networking_v1_transit_gateway_attachment
- list_networking_v1_transit_gateway_attachments
Make a request to read a transit gateway attachment.
SELECT
id,
api_version,
kind,
metadata,
spec,
status
FROM confluent.networking.transit_gateway_attachments
WHERE environment = '{{ environment }}' -- required
AND id = '{{ id }}' -- required
;
Retrieve a sorted, filtered, paginated list of all transit gateway attachments.
SELECT
id,
api_version,
kind,
metadata,
spec,
status
FROM confluent.networking.transit_gateway_attachments
WHERE environment = '{{ environment }}' -- required
AND spec.display_name = '{{ spec.display_name }}'
AND status.phase = '{{ status.phase }}'
AND spec.network = '{{ spec.network }}'
AND page_size = '{{ page_size }}'
AND page_token = '{{ page_token }}'
;
INSERT examples
- create_networking_v1_transit_gateway_attachment
- Manifest
Make a request to create a transit gateway attachment.
INSERT INTO confluent.networking.transit_gateway_attachments (
spec
)
SELECT
'{{ spec }}' /* required */
RETURNING
id,
api_version,
kind,
metadata,
spec,
status
;
# Description fields are for documentation purposes
- name: transit_gateway_attachments
props:
- name: spec
description: |
The desired state of the Transit Gateway Attachment
value:
display_name: "{{ display_name }}"
cloud:
kind: "{{ kind }}"
ram_share_arn: "{{ ram_share_arn }}"
transit_gateway_id: "{{ transit_gateway_id }}"
routes:
- "{{ routes }}"
environment:
id: "{{ id }}"
environment: "{{ environment }}"
related: "{{ related }}"
resource_name: "{{ resource_name }}"
api_version: "{{ api_version }}"
kind: "{{ kind }}"
network:
id: "{{ id }}"
environment: "{{ environment }}"
related: "{{ related }}"
resource_name: "{{ resource_name }}"
api_version: "{{ api_version }}"
kind: "{{ kind }}"
UPDATE examples
- update_networking_v1_transit_gateway_attachment
Make a request to update a transit gateway attachment.
UPDATE confluent.networking.transit_gateway_attachments
SET
spec = '{{ spec }}'
WHERE
id = '{{ id }}' --required
AND spec = '{{ spec }}' --required
RETURNING
id,
api_version,
kind,
metadata,
spec,
status;
DELETE examples
- delete_networking_v1_transit_gateway_attachment
Make a request to delete a transit gateway attachment.
DELETE FROM confluent.networking.transit_gateway_attachments
WHERE environment = '{{ environment }}' --required
AND id = '{{ id }}' --required
;