com.amazonaws.services.elasticache.model
Class DescribeCacheClustersRequest

java.lang.Object
  com.amazonaws.AmazonWebServiceRequest
      com.amazonaws.services.elasticache.model.DescribeCacheClustersRequest

All Implemented Interfaces:

Serializable

public class DescribeCacheClustersRequest
extends AmazonWebServiceRequest
implements Serializable

Container for the parameters to the DescribeCacheClusters operation.

Returns information about all provisioned Cache Clusters if no Cache Cluster identifier is specified, or about a specific Cache Cluster if a Cache Cluster identifier is supplied.

Cluster information will be returned by default. An optional ShowDetails flag can be used to retrieve detailed information about the Cache Nodes associated with the Cache Cluster. Details include the DNS address and port for the Cache Node endpoint.

If the cluster is in the CREATING state, only cluster level information will be displayed until all of the nodes are successfully provisioned.

If the cluster is in the DELETING state, only cluster level information will be displayed.

While adding Cache Nodes, node endpoint information and creation time for the additional nodes will not be displayed until they are completely provisioned. The cluster lifecycle tells the customer when new nodes are AVAILABLE.

While removing existing Cache Nodes from an cluster, endpoint information for the removed nodes will not be displayed.

DescribeCacheClusters supports pagination.

See Also:

AmazonElastiCache.describeCacheClusters(DescribeCacheClustersRequest), Serialized Form

Constructor Summary

DescribeCacheClustersRequest()
Default constructor for a new DescribeCacheClustersRequest object.

Method Summary

boolean	equals(Object obj)
String	getCacheClusterId() The user-supplied cluster identifier.
String	getMarker() An optional marker provided in the previous DescribeCacheClusters request.
Integer	getMaxRecords() The maximum number of records to include in the response.
Boolean	getShowCacheNodeInfo() An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.
int	hashCode()
Boolean	isShowCacheNodeInfo() An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.
void	setCacheClusterId(String cacheClusterId) The user-supplied cluster identifier.
void	setMarker(String marker) An optional marker provided in the previous DescribeCacheClusters request.
void	setMaxRecords(Integer maxRecords) The maximum number of records to include in the response.
void	setShowCacheNodeInfo(Boolean showCacheNodeInfo) An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.
String	toString() Returns a string representation of this object; useful for testing and debugging.
DescribeCacheClustersRequest	withCacheClusterId(String cacheClusterId) The user-supplied cluster identifier.
DescribeCacheClustersRequest	withMarker(String marker) An optional marker provided in the previous DescribeCacheClusters request.
DescribeCacheClustersRequest	withMaxRecords(Integer maxRecords) The maximum number of records to include in the response.
DescribeCacheClustersRequest	withShowCacheNodeInfo(Boolean showCacheNodeInfo) An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

copyPrivateRequestParameters, getRequestClientOptions, getRequestCredentials, setRequestCredentials

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DescribeCacheClustersRequest

public DescribeCacheClustersRequest()

Default constructor for a new DescribeCacheClustersRequest object. Callers should use the setter or fluent setter (with...) methods to initialize this object after creating it.

Method Detail

getCacheClusterId

public String getCacheClusterId()

The user-supplied cluster identifier. If this parameter is specified, only information about that specific Cache Cluster is returned. This parameter isn't case sensitive.

Returns:

The user-supplied cluster identifier. If this parameter is specified, only information about that specific Cache Cluster is returned. This parameter isn't case sensitive.

setCacheClusterId

public void setCacheClusterId(String cacheClusterId)

The user-supplied cluster identifier. If this parameter is specified, only information about that specific Cache Cluster is returned. This parameter isn't case sensitive.

Parameters:

cacheClusterId - The user-supplied cluster identifier. If this parameter is specified, only information about that specific Cache Cluster is returned. This parameter isn't case sensitive.

withCacheClusterId

public DescribeCacheClustersRequest withCacheClusterId(String cacheClusterId)

The user-supplied cluster identifier. If this parameter is specified, only information about that specific Cache Cluster is returned. This parameter isn't case sensitive.

Returns a reference to this object so that method calls can be chained together.

Parameters:

cacheClusterId - The user-supplied cluster identifier. If this parameter is specified, only information about that specific Cache Cluster is returned. This parameter isn't case sensitive.

Returns:

A reference to this updated object so that method calls can be chained together.

getMaxRecords

public Integer getMaxRecords()

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

Default: 100

Constraints: minimum 20, maximum 100

Returns:

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

Default: 100

Constraints: minimum 20, maximum 100

setMaxRecords

public void setMaxRecords(Integer maxRecords)

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

Default: 100

Constraints: minimum 20, maximum 100

Parameters:

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

Default: 100

Constraints: minimum 20, maximum 100

withMaxRecords

public DescribeCacheClustersRequest withMaxRecords(Integer maxRecords)

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

Default: 100

Constraints: minimum 20, maximum 100

Returns a reference to this object so that method calls can be chained together.

Parameters:

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

Default: 100

Constraints: minimum 20, maximum 100

Returns:

A reference to this updated object so that method calls can be chained together.

getMarker

public String getMarker()

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

Returns:

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

setMarker

public void setMarker(String marker)

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

Parameters:

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

withMarker

public DescribeCacheClustersRequest withMarker(String marker)

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

Returns a reference to this object so that method calls can be chained together.

Parameters:

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

Returns:

A reference to this updated object so that method calls can be chained together.

isShowCacheNodeInfo

public Boolean isShowCacheNodeInfo()

An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

Returns:

An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

setShowCacheNodeInfo

public void setShowCacheNodeInfo(Boolean showCacheNodeInfo)

An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

Parameters:

showCacheNodeInfo - An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

withShowCacheNodeInfo

public DescribeCacheClustersRequest withShowCacheNodeInfo(Boolean showCacheNodeInfo)

An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

Returns a reference to this object so that method calls can be chained together.

Parameters:

showCacheNodeInfo - An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

Returns:

A reference to this updated object so that method calls can be chained together.

getShowCacheNodeInfo

public Boolean getShowCacheNodeInfo()

An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

Returns:

An optional flag that can be included in the DescribeCacheCluster request to retrieve Cache Nodes information.

toString

public String toString()

Returns a string representation of this object; useful for testing and debugging.

Overrides:

toString in class Object

Returns:

A string representation of this object.

See Also:

Object.toString()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object