Amazon Relational Database Service
API Reference (API Version 2014-10-31)

DescribeDBProxyTargets

Note

This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.

Returns information about DBProxyTarget objects. This API supports pagination.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

DBProxyName

The identifier of the DBProxyTarget to describe.

Type: String

Required: Yes

Filters.Filter.N

This parameter is not currently supported.

Type: Array of Filter objects

Required: No

Marker

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Type: String

Required: No

MaxRecords

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

Type: Integer

Valid Range: Minimum value of 20. Maximum value of 100.

Required: No

TargetGroupName

The identifier of the DBProxyTargetGroup to describe.

Type: String

Required: No

Response Elements

The following elements are returned by the service.

Marker

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

Type: String

Targets.member.N

An arbitrary number of DBProxyTarget objects, containing details of the corresponding targets.

Type: Array of DBProxyTarget objects

Errors

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

DBProxyNotFoundFault

The specified proxy name doesn't correspond to a proxy owned by your AWS accoutn in the specified AWS Region.

HTTP Status Code: 404

DBProxyTargetGroupNotFoundFault

The specified target group isn't available for a proxy owned by your AWS account in the specified AWS Region.

HTTP Status Code: 404

DBProxyTargetNotFoundFault

The specified RDS DB instance or Aurora DB cluster isn't available for a proxy owned by your AWS account in the specified AWS Region.

HTTP Status Code: 404

See Also

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