Skip to main content

pipeline_endpoint_connections

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

Overview​

Namepipeline_endpoint_connections
TypeResource
Idaws.osis.pipeline_endpoint_connections

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
endpoint_idstringThe unique identifier of the endpoint in the connection. (pattern: <code>^[a-zA-Z0-9][a-zA-Z0-9-_]+$</code>)
pipeline_arnstringThe Amazon Resource Name (ARN) of the pipeline in the endpoint connection. (pattern: <code>^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):osis:.+:pipeline/.+$</code>)
statusstringThe current status of the pipeline endpoint connection. (CREATING, ACTIVE, CREATE_FAILED, DELETING, REVOKING, REVOKED)
vpc_endpoint_ownerstringThe Amazon Web Services account ID that owns the VPC endpoint used in this connection. (pattern: <code>^\d{12}$</code>)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_pipeline_endpoint_connectionsselectregionmaxResults, nextTokenLists the pipeline endpoints connected to pipelines in your account.
revoke_pipeline_endpoint_connectionsupdateregion, PipelineArn, EndpointIdsRevokes pipeline endpoints from specified endpoint IDs.

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
regionstringAWS region (default: us-east-1)
maxResultsintegerThe maximum number of pipeline endpoint connections to return in the response.
nextTokenstringIf your initial ListPipelineEndpointConnections operation returns a nextToken, you can include the returned nextToken in subsequent ListPipelineEndpointConnections operations, which returns results in the next page.

SELECT examples​

Lists the pipeline endpoints connected to pipelines in your account.

SELECT
endpoint_id,
pipeline_arn,
status,
vpc_endpoint_owner
FROM aws.osis.pipeline_endpoint_connections
WHERE region = '{{ region }}' -- required
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;

UPDATE examples​

Revokes pipeline endpoints from specified endpoint IDs.

UPDATE aws.osis.pipeline_endpoint_connections
SET
PipelineArn = '{{ PipelineArn }}',
EndpointIds = '{{ EndpointIds }}'
WHERE
region = '{{ region }}' --required
AND PipelineArn = '{{ PipelineArn }}' --required
AND EndpointIds = '{{ EndpointIds }}' --required
RETURNING
pipeline_arn;