describe_cluster

describe_cluster(**kwargs)

Display the details about a cluster. The response includes the cluster name, endpoints, status, and Amazon Resource Name (ARN).

See also: AWS API Documentation

Request Syntax

response = client.describe_cluster(
    ClusterArn='string'
)
Parameters
ClusterArn (string) --

[REQUIRED]

The Amazon Resource Name (ARN) of the cluster.

Return type
dict
Returns
Response Syntax
{
    'Cluster': {
        'ClusterArn': 'string',
        'ClusterEndpoints': [
            {
                'Endpoint': 'string',
                'Region': 'string'
            },
        ],
        'Name': 'string',
        'Status': 'PENDING'|'DEPLOYED'|'PENDING_DELETION'
    }
}

Response Structure

  • (dict) --

    200 response - Success.

    • Cluster (dict) --

      The cluster for the DescribeCluster request.

      • ClusterArn (string) --

        The Amazon Resource Name (ARN) of the cluster.

      • ClusterEndpoints (list) --

        Endpoints for a cluster. Specify one of these endpoints when you want to set or retrieve a routing control state in the cluster.

        To get or update the routing control state, see the Amazon Route 53 Application Recovery Controller Routing Control Actions.

        • (dict) --

          A cluster endpoint. Specify an endpoint when you want to set or retrieve a routing control state in the cluster.

          • Endpoint (string) --

            A cluster endpoint. Specify an endpoint and Amazon Web Services Region when you want to set or retrieve a routing control state in the cluster.

            To get or update the routing control state, see the Amazon Route 53 Application Recovery Controller Routing Control Actions.

          • Region (string) --

            The Amazon Web Services Region for a cluster endpoint.

      • Name (string) --

        The name of the cluster.

      • Status (string) --

        Deployment status of a resource. Status can be one of the following: PENDING, DEPLOYED, PENDING_DELETION.

Exceptions

  • Route53RecoveryControlConfig.Client.exceptions.ValidationException
  • Route53RecoveryControlConfig.Client.exceptions.InternalServerException
  • Route53RecoveryControlConfig.Client.exceptions.AccessDeniedException
  • Route53RecoveryControlConfig.Client.exceptions.ResourceNotFoundException
  • Route53RecoveryControlConfig.Client.exceptions.ThrottlingException
  • Route53RecoveryControlConfig.Client.exceptions.ConflictException