Skip to main content

private_link_accesses

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

Overview

Nameprivate_link_accesses
TypeResource
Idconfluent.networking.private_link_accesses

Fields

The following fields are returned by SELECT queries:

Private Link Access.

NameDatatypeDescription
idstringID 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_versionstringAPIVersion defines the schema version of this representation of a resource. (networking/v1)
kindstringKind defines the object this REST resource represents. (PrivateLinkAccess)
metadataobjectObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
specobjectThe desired state of the Private Link Access
statusobjectThe status of the Private Link Access

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_networking_v1_private_link_accessselectenvironment, idMake a request to read a private link access.
list_networking_v1_private_link_accessesselectenvironmentspec.display_name, status.phase, spec.network, page_size, page_tokenRetrieve a sorted, filtered, paginated list of all private link accesses.
create_networking_v1_private_link_accessinsertspecMake a request to create a private link access.
update_networking_v1_private_link_accessupdateid, specMake a request to update a private link access.

delete_networking_v1_private_link_accessdeleteenvironment, idMake a request to delete a private link access.

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.

NameDatatypeDescription
environmentstringScope the operation to the given environment. (example: env-00000)
idstringThe unique identifier for the private link access.
page_sizeintegerA pagination size for collection requests.
page_tokenstringAn opaque pagination token for collection requests.
spec.display_namearrayFilter the results by exact match for spec.display_name. Pass multiple times to see results matching any of the values. (example: [prod-pl-use1, prod-pl-usw2])
spec.networkarrayFilter 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.phasearrayFilter the results by exact match for status.phase. Pass multiple times to see results matching any of the values. (example: [PROVISIONING, READY])

SELECT examples

Make a request to read a private link access.

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

INSERT examples

Make a request to create a private link access.

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

UPDATE examples

Make a request to update a private link access.

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

DELETE examples

Make a request to delete a private link access.

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