We recommend new projects start with resources from the AWS provider.
aws-native.docdbelastic.getCluster
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
The AWS::DocDBElastic::Cluster Amazon DocumentDB (with MongoDB compatibility) Elastic Scale resource describes a Cluster
Using getCluster
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 getCluster(args: GetClusterArgs, opts?: InvokeOptions): Promise<GetClusterResult>
function getClusterOutput(args: GetClusterOutputArgs, opts?: InvokeOptions): Output<GetClusterResult>
def get_cluster(cluster_arn: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetClusterResult
def get_cluster_output(cluster_arn: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetClusterResult]
func LookupCluster(ctx *Context, args *LookupClusterArgs, opts ...InvokeOption) (*LookupClusterResult, error)
func LookupClusterOutput(ctx *Context, args *LookupClusterOutputArgs, opts ...InvokeOption) LookupClusterResultOutput
> Note: This function is named LookupCluster
in the Go SDK.
public static class GetCluster
{
public static Task<GetClusterResult> InvokeAsync(GetClusterArgs args, InvokeOptions? opts = null)
public static Output<GetClusterResult> Invoke(GetClusterInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetClusterResult> getCluster(GetClusterArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:docdbelastic:getCluster
arguments:
# arguments dictionary
The following arguments are supported:
- Cluster
Arn string
- Cluster
Arn string
- cluster
Arn String
- cluster
Arn string
- cluster_
arn str
- cluster
Arn String
getCluster Result
The following output properties are available:
- Backup
Retention intPeriod - The number of days for which automatic snapshots are retained.
- Cluster
Arn string - Cluster
Endpoint string - The URL used to connect to the elastic cluster.
- Preferred
Backup stringWindow - The daily time range during which automated backups are created if automated backups are enabled, as determined by
backupRetentionPeriod
. - Preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
Format :
ddd:hh24:mi-ddd:hh24:mi
Default : a 30-minute window selected at random from an 8-hour block of time for each AWS Region , occurring on a random day of the week.
Valid days : Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints : Minimum 30-minute window.
- int
- The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.
- int
- The number of shards assigned to the elastic cluster. Maximum is 32.
- int
- The number of replica instances applying to all shards in the cluster. A
shardInstanceCount
value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability. - Subnet
Ids List<string> - The Amazon EC2 subnet IDs for the new elastic cluster.
- List<Pulumi.
Aws Native. Outputs. Tag> - The tags to be assigned to the new elastic cluster.
- Vpc
Security List<string>Group Ids - A list of EC2 VPC security groups to associate with the new elastic cluster.
- Backup
Retention intPeriod - The number of days for which automatic snapshots are retained.
- Cluster
Arn string - Cluster
Endpoint string - The URL used to connect to the elastic cluster.
- Preferred
Backup stringWindow - The daily time range during which automated backups are created if automated backups are enabled, as determined by
backupRetentionPeriod
. - Preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
Format :
ddd:hh24:mi-ddd:hh24:mi
Default : a 30-minute window selected at random from an 8-hour block of time for each AWS Region , occurring on a random day of the week.
Valid days : Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints : Minimum 30-minute window.
- int
- The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.
- int
- The number of shards assigned to the elastic cluster. Maximum is 32.
- int
- The number of replica instances applying to all shards in the cluster. A
shardInstanceCount
value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability. - Subnet
Ids []string - The Amazon EC2 subnet IDs for the new elastic cluster.
- Tag
- The tags to be assigned to the new elastic cluster.
- Vpc
Security []stringGroup Ids - A list of EC2 VPC security groups to associate with the new elastic cluster.
- backup
Retention IntegerPeriod - The number of days for which automatic snapshots are retained.
- cluster
Arn String - cluster
Endpoint String - The URL used to connect to the elastic cluster.
- preferred
Backup StringWindow - The daily time range during which automated backups are created if automated backups are enabled, as determined by
backupRetentionPeriod
. - preferred
Maintenance StringWindow The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
Format :
ddd:hh24:mi-ddd:hh24:mi
Default : a 30-minute window selected at random from an 8-hour block of time for each AWS Region , occurring on a random day of the week.
Valid days : Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints : Minimum 30-minute window.
- Integer
- The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.
- Integer
- The number of shards assigned to the elastic cluster. Maximum is 32.
- Integer
- The number of replica instances applying to all shards in the cluster. A
shardInstanceCount
value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability. - subnet
Ids List<String> - The Amazon EC2 subnet IDs for the new elastic cluster.
- List<Tag>
- The tags to be assigned to the new elastic cluster.
- vpc
Security List<String>Group Ids - A list of EC2 VPC security groups to associate with the new elastic cluster.
- backup
Retention numberPeriod - The number of days for which automatic snapshots are retained.
- cluster
Arn string - cluster
Endpoint string - The URL used to connect to the elastic cluster.
- preferred
Backup stringWindow - The daily time range during which automated backups are created if automated backups are enabled, as determined by
backupRetentionPeriod
. - preferred
Maintenance stringWindow The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
Format :
ddd:hh24:mi-ddd:hh24:mi
Default : a 30-minute window selected at random from an 8-hour block of time for each AWS Region , occurring on a random day of the week.
Valid days : Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints : Minimum 30-minute window.
- number
- The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.
- number
- The number of shards assigned to the elastic cluster. Maximum is 32.
- number
- The number of replica instances applying to all shards in the cluster. A
shardInstanceCount
value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability. - subnet
Ids string[] - The Amazon EC2 subnet IDs for the new elastic cluster.
- Tag[]
- The tags to be assigned to the new elastic cluster.
- vpc
Security string[]Group Ids - A list of EC2 VPC security groups to associate with the new elastic cluster.
- backup_
retention_ intperiod - The number of days for which automatic snapshots are retained.
- cluster_
arn str - cluster_
endpoint str - The URL used to connect to the elastic cluster.
- preferred_
backup_ strwindow - The daily time range during which automated backups are created if automated backups are enabled, as determined by
backupRetentionPeriod
. - preferred_
maintenance_ strwindow The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
Format :
ddd:hh24:mi-ddd:hh24:mi
Default : a 30-minute window selected at random from an 8-hour block of time for each AWS Region , occurring on a random day of the week.
Valid days : Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints : Minimum 30-minute window.
- int
- The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.
- int
- The number of shards assigned to the elastic cluster. Maximum is 32.
- int
- The number of replica instances applying to all shards in the cluster. A
shardInstanceCount
value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability. - subnet_
ids Sequence[str] - The Amazon EC2 subnet IDs for the new elastic cluster.
- Sequence[root_Tag]
- The tags to be assigned to the new elastic cluster.
- vpc_
security_ Sequence[str]group_ ids - A list of EC2 VPC security groups to associate with the new elastic cluster.
- backup
Retention NumberPeriod - The number of days for which automatic snapshots are retained.
- cluster
Arn String - cluster
Endpoint String - The URL used to connect to the elastic cluster.
- preferred
Backup StringWindow - The daily time range during which automated backups are created if automated backups are enabled, as determined by
backupRetentionPeriod
. - preferred
Maintenance StringWindow The weekly time range during which system maintenance can occur, in Universal Coordinated Time (UTC).
Format :
ddd:hh24:mi-ddd:hh24:mi
Default : a 30-minute window selected at random from an 8-hour block of time for each AWS Region , occurring on a random day of the week.
Valid days : Mon, Tue, Wed, Thu, Fri, Sat, Sun
Constraints : Minimum 30-minute window.
- Number
- The number of vCPUs assigned to each elastic cluster shard. Maximum is 64. Allowed values are 2, 4, 8, 16, 32, 64.
- Number
- The number of shards assigned to the elastic cluster. Maximum is 32.
- Number
- The number of replica instances applying to all shards in the cluster. A
shardInstanceCount
value of 1 means there is one writer instance, and any additional instances are replicas that can be used for reads and to improve availability. - subnet
Ids List<String> - The Amazon EC2 subnet IDs for the new elastic cluster.
- List<Property Map>
- The tags to be assigned to the new elastic cluster.
- vpc
Security List<String>Group Ids - A list of EC2 VPC security groups to associate with the new elastic cluster.
Supporting Types
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.