AmazonPipes (AWS SDK for Java

All Known Subinterfaces:

AmazonPipesAsync

All Known Implementing Classes:

AbstractAmazonPipes, AbstractAmazonPipesAsync, AmazonPipesAsyncClient, AmazonPipesClient
```
@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AmazonPipes
```
Interface for accessing Amazon EventBridge Pipes.
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAmazonPipes instead.

Amazon EventBridge Pipes connects event sources to targets. Pipes reduces the need for specialized knowledge and integration code when developing event driven architectures. This helps ensures consistency across your company’s applications. With Pipes, the target can be any available EventBridge target. To set up a pipe, you select the event source, add optional event filtering, define optional enrichment, and select the target for the event data.

Field Summary

Fields
Modifier and Type Field and Description

static String ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.

Fields
Modifier and Type	Field and Description
`static String`	`ENDPOINT_PREFIX` The region metadata service name for computing region endpoints.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`CreatePipeResult`	`createPipe(CreatePipeRequest createPipeRequest)` Create a pipe.
`DeletePipeResult`	`deletePipe(DeletePipeRequest deletePipeRequest)` Delete an existing pipe.
`DescribePipeResult`	`describePipe(DescribePipeRequest describePipeRequest)` Get the information about an existing pipe.
`ResponseMetadata`	`getCachedResponseMetadata(AmazonWebServiceRequest request)` Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected.
`ListPipesResult`	`listPipes(ListPipesRequest listPipesRequest)` Get the pipes associated with this account.
`ListTagsForResourceResult`	`listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)` Displays the tags associated with a pipe.
`void`	`shutdown()` Shuts down this client object, releasing any resources that might be held open.
`StartPipeResult`	`startPipe(StartPipeRequest startPipeRequest)` Start an existing pipe.
`StopPipeResult`	`stopPipe(StopPipeRequest stopPipeRequest)` Stop an existing pipe.
`TagResourceResult`	`tagResource(TagResourceRequest tagResourceRequest)` Assigns one or more tags (key-value pairs) to the specified pipe.
`UntagResourceResult`	`untagResource(UntagResourceRequest untagResourceRequest)` Removes one or more tags from the specified pipes.
`UpdatePipeResult`	`updatePipe(UpdatePipeRequest updatePipeRequest)` Update an existing pipe.

- Field Detail
  - ENDPOINT_PREFIX
```
static final String ENDPOINT_PREFIX
```
    The region metadata service name for computing region endpoints. You can use this value to retrieve metadata (such as supported regions) of the service.
    
    See Also:
    
    RegionUtils.getRegionsForService(String), Constant Field Values
- Method Detail
  - createPipe
```
CreatePipeResult createPipe(CreatePipeRequest createPipeRequest)
```
    Create a pipe. Amazon EventBridge Pipes connect event sources to targets and reduces the need for specialized knowledge and integration code.
    
    Parameters:
    
    createPipeRequest -
    
    Returns:
    
    Result of the CreatePipe operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    ThrottlingException - An action was throttled.
    
    NotFoundException - An entity that you specified does not exist.
    
    ConflictException - An action you attempted resulted in an exception.
    
    ServiceQuotaExceededException - A quota has been exceeded.
    
    See Also:
    
    AWS API Documentation
  - deletePipe
```
DeletePipeResult deletePipe(DeletePipeRequest deletePipeRequest)
```
    Delete an existing pipe. For more information about pipes, see Amazon EventBridge Pipes in the Amazon EventBridge User Guide.
    
    Parameters:
    
    deletePipeRequest -
    
    Returns:
    
    Result of the DeletePipe operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    ThrottlingException - An action was throttled.
    
    NotFoundException - An entity that you specified does not exist.
    
    ConflictException - An action you attempted resulted in an exception.
    
    See Also:
    
    AWS API Documentation
  - describePipe
```
DescribePipeResult describePipe(DescribePipeRequest describePipeRequest)
```
    Get the information about an existing pipe. For more information about pipes, see Amazon EventBridge Pipes in the Amazon EventBridge User Guide.
    
    Parameters:
    
    describePipeRequest -
    
    Returns:
    
    Result of the DescribePipe operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    ThrottlingException - An action was throttled.
    
    NotFoundException - An entity that you specified does not exist.
    
    See Also:
    
    AWS API Documentation
  - listPipes
```
ListPipesResult listPipes(ListPipesRequest listPipesRequest)
```
    Get the pipes associated with this account. For more information about pipes, see Amazon EventBridge Pipes in the Amazon EventBridge User Guide.
    
    Parameters:
    
    listPipesRequest -
    
    Returns:
    
    Result of the ListPipes operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    ThrottlingException - An action was throttled.
    
    See Also:
    
    AWS API Documentation
  - listTagsForResource
```
ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
```
    Displays the tags associated with a pipe.
    
    Parameters:
    
    listTagsForResourceRequest -
    
    Returns:
    
    Result of the ListTagsForResource operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    NotFoundException - An entity that you specified does not exist.
    
    See Also:
    
    AWS API Documentation
  - startPipe
```
StartPipeResult startPipe(StartPipeRequest startPipeRequest)
```
    Start an existing pipe.
    
    Parameters:
    
    startPipeRequest -
    
    Returns:
    
    Result of the StartPipe operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    ThrottlingException - An action was throttled.
    
    NotFoundException - An entity that you specified does not exist.
    
    ConflictException - An action you attempted resulted in an exception.
    
    See Also:
    
    AWS API Documentation
  - stopPipe
```
StopPipeResult stopPipe(StopPipeRequest stopPipeRequest)
```
    Stop an existing pipe.
    
    Parameters:
    
    stopPipeRequest -
    
    Returns:
    
    Result of the StopPipe operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    ThrottlingException - An action was throttled.
    
    NotFoundException - An entity that you specified does not exist.
    
    ConflictException - An action you attempted resulted in an exception.
    
    See Also:
    
    AWS API Documentation
  - tagResource
```
TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
```
    Assigns one or more tags (key-value pairs) to the specified pipe. Tags can help you organize and categorize your resources. You can also use them to scope user permissions by granting a user permission to access or change only resources with certain tag values.
    
    Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly as strings of characters.
    
    You can use the TagResource action with a pipe that already has tags. If you specify a new tag key, this tag is appended to the list of tags associated with the pipe. If you specify a tag key that is already associated with the pipe, the new tag value that you specify replaces the previous value for that tag.
    
    You can associate as many as 50 tags with a pipe.
    
    Parameters:
    
    tagResourceRequest -
    
    Returns:
    
    Result of the TagResource operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    NotFoundException - An entity that you specified does not exist.
    
    See Also:
    
    AWS API Documentation
  - untagResource
```
UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
```
    Removes one or more tags from the specified pipes.
    
    Parameters:
    
    untagResourceRequest -
    
    Returns:
    
    Result of the UntagResource operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    NotFoundException - An entity that you specified does not exist.
    
    See Also:
    
    AWS API Documentation
  - updatePipe
```
UpdatePipeResult updatePipe(UpdatePipeRequest updatePipeRequest)
```
    Update an existing pipe. When you call UpdatePipe, only the fields that are included in the request are changed, the rest are unchanged. The exception to this is if you modify any Amazon Web Services-service specific fields in the SourceParameters, EnrichmentParameters, or TargetParameters objects. The fields in these objects are updated atomically as one and override existing values. This is by design and means that if you don't specify an optional field in one of these Parameters objects, that field will be set to its system-default value after the update.
    
    For more information about pipes, see Amazon EventBridge Pipes in the Amazon EventBridge User Guide.
    
    Parameters:
    
    updatePipeRequest -
    
    Returns:
    
    Result of the UpdatePipe operation returned by the service.
    
    Throws:
    
    InternalException - This exception occurs due to unexpected causes.
    
    ValidationException - Indicates that an error has occurred while performing a validate operation.
    
    ThrottlingException - An action was throttled.
    
    NotFoundException - An entity that you specified does not exist.
    
    ConflictException - An action you attempted resulted in an exception.
    
    See Also:
    
    AWS API Documentation
  - shutdown
```
void shutdown()
```
    Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.
  - getCachedResponseMetadata
```
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
```
    Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.
    Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
    
    Parameters:
    
    request - The originally executed request.
    
    Returns:
    
    The response metadata for the specified request, or null if none is available.

AWS SDK for Java 1.x API Reference - 1.12.521

Interface AmazonPipes

Field Summary

Method Summary

Field Detail

ENDPOINT_PREFIX

Method Detail

createPipe

deletePipe

describePipe

listPipes

listTagsForResource

startPipe

stopPipe

tagResource

untagResource

updatePipe

shutdown

getCachedResponseMetadata