Menu
Amazon Kinesis Firehose API Reference
API Reference (API Version 2015-08-04)

ListDeliveryStreams

Lists your delivery streams.

The number of delivery streams might be too large to return using a single call to ListDeliveryStreams. You can limit the number of delivery streams returned, using the Limit parameter. To determine whether there are more delivery streams to list, check the value of HasMoreDeliveryStreams in the output. If there are more delivery streams to list, you can request them by specifying the name of the last delivery stream returned in the call in the ExclusiveStartDeliveryStreamName parameter of a subsequent call.

Request Syntax

{ "DeliveryStreamType": "string", "ExclusiveStartDeliveryStreamName": "string", "Limit": number }

Request Parameters

The request accepts the following data in JSON format.

DeliveryStreamType

The delivery stream type. This can be one of the following values:

  • DirectPut: Provider applications access the delivery stream directly.

  • KinesisStreamAsSource: The delivery stream uses a Kinesis stream as a source.

This parameter is optional. If this parameter is omitted, delivery streams of all types are returned.

Type: String

Valid Values: DirectPut | KinesisStreamAsSource

Required: No

ExclusiveStartDeliveryStreamName

The name of the delivery stream to start the list with.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9_.-]+

Required: No

Limit

The maximum number of delivery streams to list. The default value is 10.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 10000.

Required: No

Response Syntax

{ "DeliveryStreamNames": [ "string" ], "HasMoreDeliveryStreams": boolean }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

DeliveryStreamNames

The names of the delivery streams.

Type: Array of strings

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9_.-]+

HasMoreDeliveryStreams

Indicates whether there are more delivery streams available to list.

Type: Boolean

Errors

For information about the errors that are common to all actions, see Common Errors.

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: