published on Wednesday, Mar 11, 2026 by Pulumi
published on Wednesday, Mar 11, 2026 by Pulumi
Data source for managing an AWS RDS (Relational Database) Global Cluster.
Example Usage
Basic Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = aws.rds.getGlobalCluster({
identifier: test.globalClusterIdentifier,
});
import pulumi
import pulumi_aws as aws
example = aws.rds.get_global_cluster(identifier=test["globalClusterIdentifier"])
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/rds"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := rds.LookupGlobalCluster(ctx, &rds.LookupGlobalClusterArgs{
Identifier: test.GlobalClusterIdentifier,
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var example = Aws.Rds.GetGlobalCluster.Invoke(new()
{
Identifier = test.GlobalClusterIdentifier,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.rds.RdsFunctions;
import com.pulumi.aws.rds.inputs.GetGlobalClusterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var example = RdsFunctions.getGlobalCluster(GetGlobalClusterArgs.builder()
.identifier(test.globalClusterIdentifier())
.build());
}
}
variables:
example:
fn::invoke:
function: aws:rds:getGlobalCluster
arguments:
identifier: ${test.globalClusterIdentifier}
Using getGlobalCluster
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getGlobalCluster(args: GetGlobalClusterArgs, opts?: InvokeOptions): Promise<GetGlobalClusterResult>
function getGlobalClusterOutput(args: GetGlobalClusterOutputArgs, opts?: InvokeOptions): Output<GetGlobalClusterResult>def get_global_cluster(identifier: Optional[str] = None,
region: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetGlobalClusterResult
def get_global_cluster_output(identifier: Optional[pulumi.Input[str]] = None,
region: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetGlobalClusterResult]func LookupGlobalCluster(ctx *Context, args *LookupGlobalClusterArgs, opts ...InvokeOption) (*LookupGlobalClusterResult, error)
func LookupGlobalClusterOutput(ctx *Context, args *LookupGlobalClusterOutputArgs, opts ...InvokeOption) LookupGlobalClusterResultOutput> Note: This function is named LookupGlobalCluster in the Go SDK.
public static class GetGlobalCluster
{
public static Task<GetGlobalClusterResult> InvokeAsync(GetGlobalClusterArgs args, InvokeOptions? opts = null)
public static Output<GetGlobalClusterResult> Invoke(GetGlobalClusterInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetGlobalClusterResult> getGlobalCluster(GetGlobalClusterArgs args, InvokeOptions options)
public static Output<GetGlobalClusterResult> getGlobalCluster(GetGlobalClusterArgs args, InvokeOptions options)
fn::invoke:
function: aws:rds/getGlobalCluster:getGlobalCluster
arguments:
# arguments dictionaryThe following arguments are supported:
- Identifier string
The global cluster identifier of the RDS global cluster.
The following arguments are optional:
- Region string
- Region where this resource will be managed. Defaults to the Region set in the provider configuration.
- Identifier string
The global cluster identifier of the RDS global cluster.
The following arguments are optional:
- Region string
- Region where this resource will be managed. Defaults to the Region set in the provider configuration.
- identifier String
The global cluster identifier of the RDS global cluster.
The following arguments are optional:
- region String
- Region where this resource will be managed. Defaults to the Region set in the provider configuration.
- identifier string
The global cluster identifier of the RDS global cluster.
The following arguments are optional:
- region string
- Region where this resource will be managed. Defaults to the Region set in the provider configuration.
- identifier str
The global cluster identifier of the RDS global cluster.
The following arguments are optional:
- region str
- Region where this resource will be managed. Defaults to the Region set in the provider configuration.
- identifier String
The global cluster identifier of the RDS global cluster.
The following arguments are optional:
- region String
- Region where this resource will be managed. Defaults to the Region set in the provider configuration.
getGlobalCluster Result
The following output properties are available:
- Arn string
- RDS Global Cluster Amazon Resource Name (ARN)
- Database
Name string - Name of the automatically created database on cluster creation.
- Deletion
Protection bool - If the Global Cluster should have deletion protection enabled. The database can't be deleted when this value is set to
true. - Endpoint string
- The endpoint for the Global Cluster.
- Engine string
- Name of the database engine.
- Engine
Lifecycle stringSupport - The current lifecycle support status of the database engine for this Global Cluster.
- Engine
Version string - Version of the database engine for this Global Cluster.
- Id string
- The provider-assigned unique ID for this managed resource.
- Identifier string
- Members
List<Get
Global Cluster Member> - Set of objects containing Global Cluster members.
- Region string
- Resource
Id string - AWS Region-unique, immutable identifier for the global database cluster.
- Storage
Encrypted bool - Whether the DB cluster is encrypted.
- Dictionary<string, string>
- A map of tags to assigned to the Global Cluster.
- Arn string
- RDS Global Cluster Amazon Resource Name (ARN)
- Database
Name string - Name of the automatically created database on cluster creation.
- Deletion
Protection bool - If the Global Cluster should have deletion protection enabled. The database can't be deleted when this value is set to
true. - Endpoint string
- The endpoint for the Global Cluster.
- Engine string
- Name of the database engine.
- Engine
Lifecycle stringSupport - The current lifecycle support status of the database engine for this Global Cluster.
- Engine
Version string - Version of the database engine for this Global Cluster.
- Id string
- The provider-assigned unique ID for this managed resource.
- Identifier string
- Members
[]Get
Global Cluster Member - Set of objects containing Global Cluster members.
- Region string
- Resource
Id string - AWS Region-unique, immutable identifier for the global database cluster.
- Storage
Encrypted bool - Whether the DB cluster is encrypted.
- map[string]string
- A map of tags to assigned to the Global Cluster.
- arn String
- RDS Global Cluster Amazon Resource Name (ARN)
- database
Name String - Name of the automatically created database on cluster creation.
- deletion
Protection Boolean - If the Global Cluster should have deletion protection enabled. The database can't be deleted when this value is set to
true. - endpoint String
- The endpoint for the Global Cluster.
- engine String
- Name of the database engine.
- engine
Lifecycle StringSupport - The current lifecycle support status of the database engine for this Global Cluster.
- engine
Version String - Version of the database engine for this Global Cluster.
- id String
- The provider-assigned unique ID for this managed resource.
- identifier String
- members
List<Get
Global Cluster Member> - Set of objects containing Global Cluster members.
- region String
- resource
Id String - AWS Region-unique, immutable identifier for the global database cluster.
- storage
Encrypted Boolean - Whether the DB cluster is encrypted.
- Map<String,String>
- A map of tags to assigned to the Global Cluster.
- arn string
- RDS Global Cluster Amazon Resource Name (ARN)
- database
Name string - Name of the automatically created database on cluster creation.
- deletion
Protection boolean - If the Global Cluster should have deletion protection enabled. The database can't be deleted when this value is set to
true. - endpoint string
- The endpoint for the Global Cluster.
- engine string
- Name of the database engine.
- engine
Lifecycle stringSupport - The current lifecycle support status of the database engine for this Global Cluster.
- engine
Version string - Version of the database engine for this Global Cluster.
- id string
- The provider-assigned unique ID for this managed resource.
- identifier string
- members
Get
Global Cluster Member[] - Set of objects containing Global Cluster members.
- region string
- resource
Id string - AWS Region-unique, immutable identifier for the global database cluster.
- storage
Encrypted boolean - Whether the DB cluster is encrypted.
- {[key: string]: string}
- A map of tags to assigned to the Global Cluster.
- arn str
- RDS Global Cluster Amazon Resource Name (ARN)
- database_
name str - Name of the automatically created database on cluster creation.
- deletion_
protection bool - If the Global Cluster should have deletion protection enabled. The database can't be deleted when this value is set to
true. - endpoint str
- The endpoint for the Global Cluster.
- engine str
- Name of the database engine.
- engine_
lifecycle_ strsupport - The current lifecycle support status of the database engine for this Global Cluster.
- engine_
version str - Version of the database engine for this Global Cluster.
- id str
- The provider-assigned unique ID for this managed resource.
- identifier str
- members
Sequence[Get
Global Cluster Member] - Set of objects containing Global Cluster members.
- region str
- resource_
id str - AWS Region-unique, immutable identifier for the global database cluster.
- storage_
encrypted bool - Whether the DB cluster is encrypted.
- Mapping[str, str]
- A map of tags to assigned to the Global Cluster.
- arn String
- RDS Global Cluster Amazon Resource Name (ARN)
- database
Name String - Name of the automatically created database on cluster creation.
- deletion
Protection Boolean - If the Global Cluster should have deletion protection enabled. The database can't be deleted when this value is set to
true. - endpoint String
- The endpoint for the Global Cluster.
- engine String
- Name of the database engine.
- engine
Lifecycle StringSupport - The current lifecycle support status of the database engine for this Global Cluster.
- engine
Version String - Version of the database engine for this Global Cluster.
- id String
- The provider-assigned unique ID for this managed resource.
- identifier String
- members List<Property Map>
- Set of objects containing Global Cluster members.
- region String
- resource
Id String - AWS Region-unique, immutable identifier for the global database cluster.
- storage
Encrypted Boolean - Whether the DB cluster is encrypted.
- Map<String>
- A map of tags to assigned to the Global Cluster.
Supporting Types
GetGlobalClusterMember
- Db
Cluster stringArn - Amazon Resource Name (ARN) of member DB Cluster
- Is
Writer bool - Whether the member is the primary DB Cluster
- Db
Cluster stringArn - Amazon Resource Name (ARN) of member DB Cluster
- Is
Writer bool - Whether the member is the primary DB Cluster
- db
Cluster StringArn - Amazon Resource Name (ARN) of member DB Cluster
- is
Writer Boolean - Whether the member is the primary DB Cluster
- db
Cluster stringArn - Amazon Resource Name (ARN) of member DB Cluster
- is
Writer boolean - Whether the member is the primary DB Cluster
- db_
cluster_ strarn - Amazon Resource Name (ARN) of member DB Cluster
- is_
writer bool - Whether the member is the primary DB Cluster
- db
Cluster StringArn - Amazon Resource Name (ARN) of member DB Cluster
- is
Writer Boolean - Whether the member is the primary DB Cluster
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
awsTerraform Provider.
published on Wednesday, Mar 11, 2026 by Pulumi
