networks

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

Overview

Name	networks
Type	Resource
Id	confluent.networking.networks

Fields

The following fields are returned by SELECT queries:

get_networking_v1_network

Network.

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. (Network)
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 Network
status	object	The status of the Network

list_networking_v1_networks

Network.

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. (Network)
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 Network
status	object	The status of the Network

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_networking_v1_network	select	environment, id		Make a request to read a network.
list_networking_v1_networks	select	environment	spec.display_name, spec.cloud, spec.region, spec.connection_types, spec.cidr, status.phase, page_size, page_token	Retrieve a sorted, filtered, paginated list of all networks.
create_networking_v1_network	insert	spec		Make a request to create a network.
update_networking_v1_network	update	id, spec		Make a request to update a network.
delete_networking_v1_network	delete	environment, id		Make a request to delete a network.

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 network.
page_size	integer	A pagination size for collection requests.
page_token	string	An opaque pagination token for collection requests.
spec.cidr	array	Filter the results by exact match for spec.cidr. Pass multiple times to see results matching any of the values. (example: [10.200.0.0/16])
spec.cloud	array	Filter the results by exact match for spec.cloud. Pass multiple times to see results matching any of the values. (example: [GCP, AWS])
spec.connection_types	array	Filter the results by exact match for spec.connection_types. Pass multiple times to see results matching any of the values. (example: [peering, privatelink])
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-gcp-us-central1, prod-aws-us-east1])
spec.region	array	Filter the results by exact match for spec.region. Pass multiple times to see results matching any of the values. (example: [us-central1, us-east-1])
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_network

Make a request to read a network.

SELECT
id,
api_version,
kind,
metadata,
spec,
status
FROM confluent.networking.networks
WHERE environment = '{{ environment }}' -- required
AND id = '{{ id }}' -- required
;

list_networking_v1_networks

Retrieve a sorted, filtered, paginated list of all networks.

SELECT
id,
api_version,
kind,
metadata,
spec,
status
FROM confluent.networking.networks
WHERE environment = '{{ environment }}' -- required
AND spec.display_name = '{{ spec.display_name }}'
AND spec.cloud = '{{ spec.cloud }}'
AND spec.region = '{{ spec.region }}'
AND spec.connection_types = '{{ spec.connection_types }}'
AND spec.cidr = '{{ spec.cidr }}'
AND status.phase = '{{ status.phase }}'
AND page_size = '{{ page_size }}'
AND page_token = '{{ page_token }}'
;

INSERT examples

create_networking_v1_network

Make a request to create a network.

INSERT INTO confluent.networking.networks (
spec
)
SELECT 
'{{ spec }}' /* required */
RETURNING
id,
api_version,
kind,
metadata,
spec,
status
;

Manifest

# Description fields are for documentation purposes
- name: networks
props:
  - name: spec
    description: |
      The desired state of the Network
    value:
      display_name: "{{ display_name }}"
      cloud: "{{ cloud }}"
      region: "{{ region }}"
      connection_types:
        - "{{ connection_types }}"
      cidr: "{{ cidr }}"
      zones:
        - "{{ zones }}"
      zones_info:
        - zone_id: "{{ zone_id }}"
          cidr: "{{ cidr }}"
      dns_config:
        resolution: "{{ resolution }}"
      reserved_cidr: "{{ reserved_cidr }}"
      environment:
        id: "{{ id }}"
        environment: "{{ environment }}"
        related: "{{ related }}"
        resource_name: "{{ resource_name }}"
        api_version: "{{ api_version }}"
        kind: "{{ kind }}"
      gateway:
        id: "{{ id }}"
        environment: "{{ environment }}"
        related: "{{ related }}"
        resource_name: "{{ resource_name }}"
        api_version: "{{ api_version }}"
        kind: "{{ kind }}"

UPDATE examples

update_networking_v1_network

Make a request to update a network.

UPDATE confluent.networking.networks
SET 
spec = '{{ spec }}'
WHERE 
id = '{{ id }}' --required
AND spec = '{{ spec }}' --required
RETURNING
id,
api_version,
kind,
metadata,
spec,
status;

DELETE examples

delete_networking_v1_network

Make a request to delete a network.

DELETE FROM confluent.networking.networks
WHERE environment = '{{ environment }}' --required
AND id = '{{ id }}' --required
;