Package software.amazon.awscdk.services.ecs

Interface CloudMapNamespaceOptions

All Superinterfaces:

CloudMapNamespaceOptionsBase, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CloudMapNamespaceOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.138.0 (build 0ca7ee8)",
           date="2026-07-31T10:49:29.108Z")
@Stability(Stable)
public interface CloudMapNamespaceOptions
extends software.amazon.jsii.JsiiSerializable, CloudMapNamespaceOptionsBase

The options for creating an AWS Cloud Map namespace.

Example:

 Cluster cluster;
 TaskDefinition taskDefinition;
 ContainerDefinitionOptions containerOptions;
 ContainerDefinition container = taskDefinition.addContainer("MyContainer", containerOptions);
 container.addPortMappings(PortMapping.builder()
         .name("api")
         .containerPort(8080)
         .build());
 cluster.addDefaultCloudMapNamespace(CloudMapNamespaceOptions.builder()
         .name("local")
         .build());
 FargateService service = FargateService.Builder.create(this, "Service")
         .cluster(cluster)
         .taskDefinition(taskDefinition)
         .minHealthyPercent(100)
         .serviceConnectConfiguration(ServiceConnectProps.builder()
                 .services(List.of(ServiceConnectService.builder()
                         .portMappingName("api")
                         .dnsName("http-api")
                         .port(80)
                         .build()))
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CloudMapNamespaceOptions.Builder	A builder for CloudMapNamespaceOptions
static final class	CloudMapNamespaceOptions.Jsii$Proxy	An implementation for CloudMapNamespaceOptions

Method Summary

Modifier and Type	Method	Description
static CloudMapNamespaceOptions.Builder	builder()
String	getName()	The name of the namespace, such as example.com.
default NamespaceType	getType()	The type of CloudMap Namespace to create.
default IVpc	getVpc()	The VPC to associate the namespace with.

Methods inherited from interface software.amazon.awscdk.services.ecs.CloudMapNamespaceOptionsBase

getUseForServiceConnect

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getName

@Stability(Stable)
@NotNull
String getName()

The name of the namespace, such as example.com.

getType

@Stability(Stable)
@Nullable
default NamespaceType getType()

The type of CloudMap Namespace to create.

Default: PrivateDns

getVpc

@Stability(Stable)
@Nullable
default IVpc getVpc()

The VPC to associate the namespace with.

This property is required for private DNS namespaces.

Default: VPC of the cluster for Private DNS Namespace, otherwise none

builder

@Stability(Stable)
static CloudMapNamespaceOptions.Builder builder()

Returns:

a CloudMapNamespaceOptions.Builder of CloudMapNamespaceOptions