Cluster Info

1#!/usr/bin/env bash
2# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3#
4# Licensed under the Apache License, Version 2.0 (the "License");
5# you may not use this file except in compliance with the License.
6# You may obtain a copy of the License at
7#
8#     http://www.apache.org/licenses/LICENSE-2.0
9#
10# Unless required by applicable law or agreed to in writing, software
11# distributed under the License is distributed on an "AS IS" BASIS,
12# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13# See the License for the specific language governing permissions and
14# limitations under the License.
15set -euo pipefail
16
17# cluster-info.sh - Get detailed information about a DSQL cluster
18#
19# Usage: ./cluster-info.sh CLUSTER_IDENTIFIER [--region REGION]
20#
21# Examples:
22#   ./cluster-info.sh abc123def456
23#   ./cluster-info.sh abc123def456 --region us-west-2
24
25if [[ $# -lt 1 ]]; then
26  echo "Usage: $0 CLUSTER_IDENTIFIER [--region REGION]"
27  echo ""
28  echo "Get detailed information about an Aurora DSQL cluster."
29  echo ""
30  echo "Arguments:"
31  echo "  CLUSTER_IDENTIFIER  The cluster identifier"
32  echo ""
33  echo "Options:"
34  echo "  --region REGION     AWS region (default: \$AWS_REGION or us-east-1)"
35  exit 1
36fi
37
38CLUSTER_ID="$1"
39shift
40
41REGION="${REGION:-${AWS_REGION:-us-east-1}}"
42
43# Parse remaining arguments
44while [[ $# -gt 0 ]]; do
45  case $1 in
46    --region)
47      REGION="$2"
48      shift 2
49      ;;
50    *)
51      echo "Unknown option: $1"
52      exit 1
53      ;;
54  esac
55done
56
57echo "Fetching cluster information for: $CLUSTER_ID"
58echo ""
59
60# Get cluster details — capture output first so AWS CLI failures aren't hidden by the pipe
61CLUSTER_JSON=$(aws dsql get-cluster \
62  --identifier "$CLUSTER_ID" \
63  --region "$REGION" \
64  --output json)
65
66echo "$CLUSTER_JSON" | jq '{
67    identifier: .identifier,
68    endpoint: .endpoint,
69    arn: .arn,
70    status: .status,
71    creationTime: .creationTime,
72    deletionProtectionEnabled: .deletionProtectionEnabled,
73    tags: .tags
74  }'
75
76echo ""
77echo "To connect with psql:"
78echo "export CLUSTER=$CLUSTER_ID"
79echo "export REGION=$REGION"
80echo "./scripts/psql-connect.sh"