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;