We recommend new projects start with resources from the AWS provider.
published on Monday, Nov 2, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
published on Monday, Nov 2, 2026 by Pulumi
Resource Type definition for AWS::RDS::DBClusterEndpoint. Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster. This resource applies only to Aurora DB clusters.
Create DbClusterEndpoint Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DbClusterEndpoint(name: string, args: DbClusterEndpointArgs, opts?: CustomResourceOptions);@overload
def DbClusterEndpoint(resource_name: str,
args: DbClusterEndpointArgs,
opts: Optional[ResourceOptions] = None)
@overload
def DbClusterEndpoint(resource_name: str,
opts: Optional[ResourceOptions] = None,
custom_endpoint_type: Optional[DbClusterEndpointCustomEndpointType] = None,
db_cluster_endpoint_identifier: Optional[str] = None,
db_cluster_identifier: Optional[str] = None,
excluded_members: Optional[Sequence[str]] = None,
static_members: Optional[Sequence[str]] = None,
tags: Optional[Sequence[_root_inputs.TagArgs]] = None)func NewDbClusterEndpoint(ctx *Context, name string, args DbClusterEndpointArgs, opts ...ResourceOption) (*DbClusterEndpoint, error)public DbClusterEndpoint(string name, DbClusterEndpointArgs args, CustomResourceOptions? opts = null)
public DbClusterEndpoint(String name, DbClusterEndpointArgs args)
public DbClusterEndpoint(String name, DbClusterEndpointArgs args, CustomResourceOptions options)
type: aws-native:rds:DbClusterEndpoint
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "aws-native_rds_db_cluster_endpoint" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args DbClusterEndpointArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args DbClusterEndpointArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args DbClusterEndpointArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DbClusterEndpointArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DbClusterEndpointArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
DbClusterEndpoint Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The DbClusterEndpoint resource accepts the following input properties:
- Custom
Endpoint Pulumi.Type Aws Native. Rds. Db Cluster Endpoint Custom Endpoint Type - The type of the custom endpoint.
- Db
Cluster stringEndpoint Identifier - The identifier to use for the new endpoint. This parameter is stored as a lowercase string.
- Db
Cluster stringIdentifier - The DB cluster identifier of the DB cluster associated with the endpoint. This parameter is stored as a lowercase string.
- Excluded
Members List<string> - List of DB instance identifiers that aren't part of the custom endpoint group. All other eligible instances are reachable through the custom endpoint. Only relevant if the list of static members is empty. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- Static
Members List<string> - List of DB instance identifiers that are part of the custom endpoint group. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
-
List<Pulumi.
Aws Native. Inputs. Tag> - The tags to be assigned to the DB cluster endpoint.
- Custom
Endpoint DbType Cluster Endpoint Custom Endpoint Type - The type of the custom endpoint.
- Db
Cluster stringEndpoint Identifier - The identifier to use for the new endpoint. This parameter is stored as a lowercase string.
- Db
Cluster stringIdentifier - The DB cluster identifier of the DB cluster associated with the endpoint. This parameter is stored as a lowercase string.
- Excluded
Members []string - List of DB instance identifiers that aren't part of the custom endpoint group. All other eligible instances are reachable through the custom endpoint. Only relevant if the list of static members is empty. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- Static
Members []string - List of DB instance identifiers that are part of the custom endpoint group. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
-
Tag
Args - The tags to be assigned to the DB cluster endpoint.
- custom_
endpoint_ "READER" | "WRITER" | "ANY"type - The type of the custom endpoint.
- db_
cluster_ stringendpoint_ identifier - The identifier to use for the new endpoint. This parameter is stored as a lowercase string.
- db_
cluster_ stringidentifier - The DB cluster identifier of the DB cluster associated with the endpoint. This parameter is stored as a lowercase string.
- excluded_
members list(string) - List of DB instance identifiers that aren't part of the custom endpoint group. All other eligible instances are reachable through the custom endpoint. Only relevant if the list of static members is empty. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- static_
members list(string) - List of DB instance identifiers that are part of the custom endpoint group. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- list(object)
- The tags to be assigned to the DB cluster endpoint.
- custom
Endpoint DbType Cluster Endpoint Custom Endpoint Type - The type of the custom endpoint.
- db
Cluster StringEndpoint Identifier - The identifier to use for the new endpoint. This parameter is stored as a lowercase string.
- db
Cluster StringIdentifier - The DB cluster identifier of the DB cluster associated with the endpoint. This parameter is stored as a lowercase string.
- excluded
Members List<String> - List of DB instance identifiers that aren't part of the custom endpoint group. All other eligible instances are reachable through the custom endpoint. Only relevant if the list of static members is empty. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- static
Members List<String> - List of DB instance identifiers that are part of the custom endpoint group. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- List<Tag>
- The tags to be assigned to the DB cluster endpoint.
- custom
Endpoint DbType Cluster Endpoint Custom Endpoint Type - The type of the custom endpoint.
- db
Cluster stringEndpoint Identifier - The identifier to use for the new endpoint. This parameter is stored as a lowercase string.
- db
Cluster stringIdentifier - The DB cluster identifier of the DB cluster associated with the endpoint. This parameter is stored as a lowercase string.
- excluded
Members string[] - List of DB instance identifiers that aren't part of the custom endpoint group. All other eligible instances are reachable through the custom endpoint. Only relevant if the list of static members is empty. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- static
Members string[] - List of DB instance identifiers that are part of the custom endpoint group. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- Tag[]
- The tags to be assigned to the DB cluster endpoint.
- custom_
endpoint_ Dbtype Cluster Endpoint Custom Endpoint Type - The type of the custom endpoint.
- db_
cluster_ strendpoint_ identifier - The identifier to use for the new endpoint. This parameter is stored as a lowercase string.
- db_
cluster_ stridentifier - The DB cluster identifier of the DB cluster associated with the endpoint. This parameter is stored as a lowercase string.
- excluded_
members Sequence[str] - List of DB instance identifiers that aren't part of the custom endpoint group. All other eligible instances are reachable through the custom endpoint. Only relevant if the list of static members is empty. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- static_
members Sequence[str] - List of DB instance identifiers that are part of the custom endpoint group. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
-
Sequence[Tag
Args] - The tags to be assigned to the DB cluster endpoint.
- custom
Endpoint "READER" | "WRITER" | "ANY"Type - The type of the custom endpoint.
- db
Cluster StringEndpoint Identifier - The identifier to use for the new endpoint. This parameter is stored as a lowercase string.
- db
Cluster StringIdentifier - The DB cluster identifier of the DB cluster associated with the endpoint. This parameter is stored as a lowercase string.
- excluded
Members List<String> - List of DB instance identifiers that aren't part of the custom endpoint group. All other eligible instances are reachable through the custom endpoint. Only relevant if the list of static members is empty. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- static
Members List<String> - List of DB instance identifiers that are part of the custom endpoint group. Once either member list is set, it can be changed or replaced by the other list, but both lists cannot be removed in place; removing them requires replacing the endpoint.
- List<Property Map>
- The tags to be assigned to the DB cluster endpoint.
Outputs
All input properties are implicitly available as output properties. Additionally, the DbClusterEndpoint resource produces the following output properties:
- Db
Cluster stringEndpoint Arn - The Amazon Resource Name (ARN) for the DB cluster endpoint.
- Db
Cluster stringEndpoint Resource Identifier - A unique system-generated identifier for an endpoint. It remains the same for the whole life of the endpoint.
- Endpoint string
- The DNS address of the endpoint.
- Endpoint
Type string - The endpoint classification returned by Amazon RDS.
- Id string
- The provider-assigned unique ID for this managed resource.
- Status string
- The current status of the endpoint.
- Db
Cluster stringEndpoint Arn - The Amazon Resource Name (ARN) for the DB cluster endpoint.
- Db
Cluster stringEndpoint Resource Identifier - A unique system-generated identifier for an endpoint. It remains the same for the whole life of the endpoint.
- Endpoint string
- The DNS address of the endpoint.
- Endpoint
Type string - The endpoint classification returned by Amazon RDS.
- Id string
- The provider-assigned unique ID for this managed resource.
- Status string
- The current status of the endpoint.
- db_
cluster_ stringendpoint_ arn - The Amazon Resource Name (ARN) for the DB cluster endpoint.
- db_
cluster_ stringendpoint_ resource_ identifier - A unique system-generated identifier for an endpoint. It remains the same for the whole life of the endpoint.
- endpoint string
- The DNS address of the endpoint.
- endpoint_
type string - The endpoint classification returned by Amazon RDS.
- id string
- The provider-assigned unique ID for this managed resource.
- status string
- The current status of the endpoint.
- db
Cluster StringEndpoint Arn - The Amazon Resource Name (ARN) for the DB cluster endpoint.
- db
Cluster StringEndpoint Resource Identifier - A unique system-generated identifier for an endpoint. It remains the same for the whole life of the endpoint.
- endpoint String
- The DNS address of the endpoint.
- endpoint
Type String - The endpoint classification returned by Amazon RDS.
- id String
- The provider-assigned unique ID for this managed resource.
- status String
- The current status of the endpoint.
- db
Cluster stringEndpoint Arn - The Amazon Resource Name (ARN) for the DB cluster endpoint.
- db
Cluster stringEndpoint Resource Identifier - A unique system-generated identifier for an endpoint. It remains the same for the whole life of the endpoint.
- endpoint string
- The DNS address of the endpoint.
- endpoint
Type string - The endpoint classification returned by Amazon RDS.
- id string
- The provider-assigned unique ID for this managed resource.
- status string
- The current status of the endpoint.
- db_
cluster_ strendpoint_ arn - The Amazon Resource Name (ARN) for the DB cluster endpoint.
- db_
cluster_ strendpoint_ resource_ identifier - A unique system-generated identifier for an endpoint. It remains the same for the whole life of the endpoint.
- endpoint str
- The DNS address of the endpoint.
- endpoint_
type str - The endpoint classification returned by Amazon RDS.
- id str
- The provider-assigned unique ID for this managed resource.
- status str
- The current status of the endpoint.
- db
Cluster StringEndpoint Arn - The Amazon Resource Name (ARN) for the DB cluster endpoint.
- db
Cluster StringEndpoint Resource Identifier - A unique system-generated identifier for an endpoint. It remains the same for the whole life of the endpoint.
- endpoint String
- The DNS address of the endpoint.
- endpoint
Type String - The endpoint classification returned by Amazon RDS.
- id String
- The provider-assigned unique ID for this managed resource.
- status String
- The current status of the endpoint.
Supporting Types
DbClusterEndpointCustomEndpointType, DbClusterEndpointCustomEndpointTypeArgs
| Name | Value |
|---|---|
| Reader | READER |
| Writer | WRITER |
| Any | ANY |
| Name | Value |
|---|---|
| Db | READER |
| Db | WRITER |
| Db | ANY |
| Value |
|---|
READER |
WRITER |
ANY |
| Name | Value |
|---|---|
| Reader | READER |
| Writer | WRITER |
| Any | ANY |
| Name | Value |
|---|---|
| Reader | READER |
| Writer | WRITER |
| Any | ANY |
| Name | Value |
|---|---|
| READER | READER |
| WRITER | WRITER |
| ANY | ANY |
| Value |
|---|
READER |
WRITER |
ANY |
Tag, TagArgs
A set of tags to apply to the resource.Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Nov 2, 2026 by Pulumi