list_pipes#

EventBridgePipes.Client.list_pipes(**kwargs)#

Get the pipes associated with this account. For more information about pipes, see Amazon EventBridge Pipes in the Amazon EventBridge User Guide.

Request Syntax

response = client.list_pipes(
    CurrentState='RUNNING'|'STOPPED'|'CREATING'|'UPDATING'|'DELETING'|'STARTING'|'STOPPING'|'CREATE_FAILED'|'UPDATE_FAILED'|'START_FAILED'|'STOP_FAILED',
    DesiredState='RUNNING'|'STOPPED',
    Limit=123,
    NamePrefix='string',
    NextToken='string',
    SourcePrefix='string',
    TargetPrefix='string'
)

Parameters:

CurrentState (string) – The state the pipe is in.
DesiredState (string) – The state the pipe should be in.
Limit (integer) – The maximum number of pipes to include in the response.
NamePrefix (string) – A value that will return a subset of the pipes associated with this account. For example, "NamePrefix": "ABC" will return all endpoints with “ABC” in the name.
NextToken (string) – If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.
SourcePrefix (string) – The prefix matching the pipe source.
TargetPrefix (string) – The prefix matching the pipe target.

Return type:

dict

Returns:

Response Syntax

{
    'NextToken': 'string',
    'Pipes': [
        {
            'Arn': 'string',
            'CreationTime': datetime(2015, 1, 1),
            'CurrentState': 'RUNNING'|'STOPPED'|'CREATING'|'UPDATING'|'DELETING'|'STARTING'|'STOPPING'|'CREATE_FAILED'|'UPDATE_FAILED'|'START_FAILED'|'STOP_FAILED',
            'DesiredState': 'RUNNING'|'STOPPED',
            'Enrichment': 'string',
            'LastModifiedTime': datetime(2015, 1, 1),
            'Name': 'string',
            'Source': 'string',
            'StateReason': 'string',
            'Target': 'string'
        },
    ]
}

Response Structure

(dict) –
- NextToken (string) –
  
  If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an HTTP 400 InvalidToken error.
- Pipes (list) –
  
  The pipes returned by the call.
  - (dict) –
    
    An object that represents a pipe. Amazon EventBridgePipes connect event sources to targets and reduces the need for specialized knowledge and integration code.
    - Arn (string) –
      
      The ARN of the pipe.
    - CreationTime (datetime) –
      
      The time the pipe was created.
    - CurrentState (string) –
      
      The state the pipe is in.
    - DesiredState (string) –
      
      The state the pipe should be in.
    - Enrichment (string) –
      
      The ARN of the enrichment resource.
    - LastModifiedTime (datetime) –
      
      When the pipe was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).
    - Name (string) –
      
      The name of the pipe.
    - Source (string) –
      
      The ARN of the source resource.
    - StateReason (string) –
      
      The reason the pipe is in its current state.
    - Target (string) –
      
      The ARN of the target resource.

Exceptions

EventBridgePipes.Client.exceptions.InternalException
EventBridgePipes.Client.exceptions.ValidationException
EventBridgePipes.Client.exceptions.ThrottlingException