Package software.amazon.awscdk.services.sagemaker

Class CfnEndpointConfig

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.CfnElement

software.amazon.awscdk.CfnRefElement

software.amazon.awscdk.CfnResource

software.amazon.awscdk.services.sagemaker.CfnEndpointConfig

All Implemented Interfaces:

IInspectable, IEnvironmentAware, IEndpointConfigRef, ITaggable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-17T14:41:00.104Z")
@Stability(Stable)
public class CfnEndpointConfig
extends CfnResource
implements IInspectable, IEndpointConfigRef, ITaggable

The AWS::SageMaker::EndpointConfig resource creates a configuration for an Amazon SageMaker endpoint.

For more information, see CreateEndpointConfig in the SageMaker Developer Guide .

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.sagemaker.*;
 CfnEndpointConfig cfnEndpointConfig = CfnEndpointConfig.Builder.create(this, "MyCfnEndpointConfig")
         .productionVariants(List.of(ProductionVariantProperty.builder()
                 .variantName("variantName")
                 // the properties below are optional
                 .acceleratorType("acceleratorType")
                 .capacityReservationConfig(CapacityReservationConfigProperty.builder()
                         .capacityReservationPreference("capacityReservationPreference")
                         .mlReservationArn("mlReservationArn")
                         .build())
                 .containerStartupHealthCheckTimeoutInSeconds(123)
                 .enableSsmAccess(false)
                 .inferenceAmiVersion("inferenceAmiVersion")
                 .initialInstanceCount(123)
                 .initialVariantWeight(123)
                 .instanceType("instanceType")
                 .managedInstanceScaling(ManagedInstanceScalingProperty.builder()
                         .maxInstanceCount(123)
                         .minInstanceCount(123)
                         .status("status")
                         .build())
                 .modelDataDownloadTimeoutInSeconds(123)
                 .modelName("modelName")
                 .routingConfig(RoutingConfigProperty.builder()
                         .routingStrategy("routingStrategy")
                         .build())
                 .serverlessConfig(ServerlessConfigProperty.builder()
                         .maxConcurrency(123)
                         .memorySizeInMb(123)
                         // the properties below are optional
                         .provisionedConcurrency(123)
                         .build())
                 .volumeSizeInGb(123)
                 .build()))
         // the properties below are optional
         .asyncInferenceConfig(AsyncInferenceConfigProperty.builder()
                 .outputConfig(AsyncInferenceOutputConfigProperty.builder()
                         .kmsKeyId("kmsKeyId")
                         .notificationConfig(AsyncInferenceNotificationConfigProperty.builder()
                                 .errorTopic("errorTopic")
                                 .includeInferenceResponseIn(List.of("includeInferenceResponseIn"))
                                 .successTopic("successTopic")
                                 .build())
                         .s3FailurePath("s3FailurePath")
                         .s3OutputPath("s3OutputPath")
                         .build())
                 // the properties below are optional
                 .clientConfig(AsyncInferenceClientConfigProperty.builder()
                         .maxConcurrentInvocationsPerInstance(123)
                         .build())
                 .build())
         .dataCaptureConfig(DataCaptureConfigProperty.builder()
                 .captureOptions(List.of(CaptureOptionProperty.builder()
                         .captureMode("captureMode")
                         .build()))
                 .destinationS3Uri("destinationS3Uri")
                 .initialSamplingPercentage(123)
                 // the properties below are optional
                 .captureContentTypeHeader(CaptureContentTypeHeaderProperty.builder()
                         .csvContentTypes(List.of("csvContentTypes"))
                         .jsonContentTypes(List.of("jsonContentTypes"))
                         .build())
                 .enableCapture(false)
                 .kmsKeyId("kmsKeyId")
                 .build())
         .enableNetworkIsolation(false)
         .endpointConfigName("endpointConfigName")
         .executionRoleArn("executionRoleArn")
         .explainerConfig(ExplainerConfigProperty.builder()
                 .clarifyExplainerConfig(ClarifyExplainerConfigProperty.builder()
                         .shapConfig(ClarifyShapConfigProperty.builder()
                                 .shapBaselineConfig(ClarifyShapBaselineConfigProperty.builder()
                                         .mimeType("mimeType")
                                         .shapBaseline("shapBaseline")
                                         .shapBaselineUri("shapBaselineUri")
                                         .build())
                                 // the properties below are optional
                                 .numberOfSamples(123)
                                 .seed(123)
                                 .textConfig(ClarifyTextConfigProperty.builder()
                                         .granularity("granularity")
                                         .language("language")
                                         .build())
                                 .useLogit(false)
                                 .build())
                         // the properties below are optional
                         .enableExplanations("enableExplanations")
                         .inferenceConfig(ClarifyInferenceConfigProperty.builder()
                                 .contentTemplate("contentTemplate")
                                 .featureHeaders(List.of("featureHeaders"))
                                 .featuresAttribute("featuresAttribute")
                                 .featureTypes(List.of("featureTypes"))
                                 .labelAttribute("labelAttribute")
                                 .labelHeaders(List.of("labelHeaders"))
                                 .labelIndex(123)
                                 .maxPayloadInMb(123)
                                 .maxRecordCount(123)
                                 .probabilityAttribute("probabilityAttribute")
                                 .probabilityIndex(123)
                                 .build())
                         .build())
                 .build())
         .kmsKeyId("kmsKeyId")
         .shadowProductionVariants(List.of(ProductionVariantProperty.builder()
                 .variantName("variantName")
                 // the properties below are optional
                 .acceleratorType("acceleratorType")
                 .capacityReservationConfig(CapacityReservationConfigProperty.builder()
                         .capacityReservationPreference("capacityReservationPreference")
                         .mlReservationArn("mlReservationArn")
                         .build())
                 .containerStartupHealthCheckTimeoutInSeconds(123)
                 .enableSsmAccess(false)
                 .inferenceAmiVersion("inferenceAmiVersion")
                 .initialInstanceCount(123)
                 .initialVariantWeight(123)
                 .instanceType("instanceType")
                 .managedInstanceScaling(ManagedInstanceScalingProperty.builder()
                         .maxInstanceCount(123)
                         .minInstanceCount(123)
                         .status("status")
                         .build())
                 .modelDataDownloadTimeoutInSeconds(123)
                 .modelName("modelName")
                 .routingConfig(RoutingConfigProperty.builder()
                         .routingStrategy("routingStrategy")
                         .build())
                 .serverlessConfig(ServerlessConfigProperty.builder()
                         .maxConcurrency(123)
                         .memorySizeInMb(123)
                         // the properties below are optional
                         .provisionedConcurrency(123)
                         .build())
                 .volumeSizeInGb(123)
                 .build()))
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .vpcConfig(VpcConfigProperty.builder()
                 .securityGroupIds(List.of("securityGroupIds"))
                 .subnets(List.of("subnets"))
                 .build())
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-endpointconfig.html

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CfnEndpointConfig.AsyncInferenceClientConfigProperty	Configures the behavior of the client used by SageMaker to interact with the model container during asynchronous inference.
static interface	CfnEndpointConfig.AsyncInferenceConfigProperty	Specifies configuration for how an endpoint performs asynchronous inference.
static interface	CfnEndpointConfig.AsyncInferenceNotificationConfigProperty	Specifies the configuration for notifications of inference results for asynchronous inference.
static interface	CfnEndpointConfig.AsyncInferenceOutputConfigProperty	Specifies the configuration for asynchronous inference invocation outputs.
static final class	CfnEndpointConfig.Builder	A fluent builder for CfnEndpointConfig.
static interface	CfnEndpointConfig.CapacityReservationConfigProperty	Example:
static interface	CfnEndpointConfig.CaptureContentTypeHeaderProperty	Specifies the JSON and CSV content types of the data that the endpoint captures.
static interface	CfnEndpointConfig.CaptureOptionProperty	Specifies whether the endpoint captures input data or output data.
static interface	CfnEndpointConfig.ClarifyExplainerConfigProperty	The configuration parameters for the SageMaker Clarify explainer.
static interface	CfnEndpointConfig.ClarifyInferenceConfigProperty	The inference configuration parameter for the model container.
static interface	CfnEndpointConfig.ClarifyShapBaselineConfigProperty	The configuration for the SHAP baseline (also called the background or reference dataset) of the Kernal SHAP algorithm.
static interface	CfnEndpointConfig.ClarifyShapConfigProperty	The configuration for SHAP analysis using SageMaker Clarify Explainer.
static interface	CfnEndpointConfig.ClarifyTextConfigProperty	A parameter used to configure the SageMaker Clarify explainer to treat text features as text so that explanations are provided for individual units of text.
static interface	CfnEndpointConfig.DataCaptureConfigProperty	Specifies the configuration of your endpoint for model monitor data capture.
static interface	CfnEndpointConfig.ExplainerConfigProperty	A parameter to activate explainers.
static interface	CfnEndpointConfig.ManagedInstanceScalingProperty	Example:
static interface	CfnEndpointConfig.ProductionVariantProperty	Specifies a model that you want to host and the resources to deploy for hosting it.
static interface	CfnEndpointConfig.RoutingConfigProperty	Example:
static interface	CfnEndpointConfig.ServerlessConfigProperty	Specifies the serverless configuration for an endpoint variant.
static interface	CfnEndpointConfig.VpcConfigProperty	Example:

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.interfaces.sagemaker.IEndpointConfigRef

IEndpointConfigRef.Jsii$Default, IEndpointConfigRef.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.ITaggable

ITaggable.Jsii$Default, ITaggable.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CFN_RESOURCE_TYPE_NAME	The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CfnEndpointConfig(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnEndpointConfig(software.amazon.jsii.JsiiObjectRef objRef)
	CfnEndpointConfig(software.constructs.Construct scope, String id, CfnEndpointConfigProps props)	Create a new AWS::SageMaker::EndpointConfig.

Method Summary

Modifier and Type	Method	Description
Object	getAsyncInferenceConfig()	Specifies configuration for how an endpoint performs asynchronous inference.
String	getAttrEndpointConfigName()	The name of the endpoint configuration, such as MyEndpointConfiguration .
String	getAttrId()
protected Map<String,Object>	getCfnProperties()
Object	getDataCaptureConfig()	Specifies how to capture endpoint data for model monitor.
Object	getEnableNetworkIsolation()	Returns union: either Boolean or IResolvable
String	getEndpointConfigName()	The name of the endpoint configuration.
EndpointConfigReference	getEndpointConfigRef()	A reference to a EndpointConfig resource.
String	getExecutionRoleArn()
Object	getExplainerConfig()	A parameter to activate explainers.
String	getKmsKeyId()	The Amazon Resource Name (ARN) of an AWS Key Management Service key that Amazon SageMaker uses to encrypt data on the storage volume attached to the ML compute instance that hosts the endpoint.
Object	getProductionVariants()	A list of ProductionVariant objects, one for each model that you want to host at this endpoint.
Object	getShadowProductionVariants()	Array of ProductionVariant objects.
TagManager	getTags()	Tag Manager which manages the tags for this resource.
List<CfnTag>	getTagsRaw()	A list of key-value pairs to apply to this resource.
Object	getVpcConfig()	Returns union: either IResolvable or CfnEndpointConfig.VpcConfigProperty
void	inspect(TreeInspector inspector)	Examines the CloudFormation resource and discloses attributes.
protected Map<String,Object>	renderProperties(Map<String,Object> props)
void	setAsyncInferenceConfig(IResolvable value)	Specifies configuration for how an endpoint performs asynchronous inference.
void	setAsyncInferenceConfig(CfnEndpointConfig.AsyncInferenceConfigProperty value)	Specifies configuration for how an endpoint performs asynchronous inference.
void	setDataCaptureConfig(IResolvable value)	Specifies how to capture endpoint data for model monitor.
void	setDataCaptureConfig(CfnEndpointConfig.DataCaptureConfigProperty value)	Specifies how to capture endpoint data for model monitor.
void	setEnableNetworkIsolation(Boolean value)
void	setEnableNetworkIsolation(IResolvable value)
void	setEndpointConfigName(String value)	The name of the endpoint configuration.
void	setExecutionRoleArn(String value)
void	setExplainerConfig(IResolvable value)	A parameter to activate explainers.
void	setExplainerConfig(CfnEndpointConfig.ExplainerConfigProperty value)	A parameter to activate explainers.
void	setKmsKeyId(String value)	The Amazon Resource Name (ARN) of an AWS Key Management Service key that Amazon SageMaker uses to encrypt data on the storage volume attached to the ML compute instance that hosts the endpoint.
void	setProductionVariants(List<Object> value)	A list of ProductionVariant objects, one for each model that you want to host at this endpoint.
void	setProductionVariants(IResolvable value)	A list of ProductionVariant objects, one for each model that you want to host at this endpoint.
void	setShadowProductionVariants(List<Object> value)	Array of ProductionVariant objects.
void	setShadowProductionVariants(IResolvable value)	Array of ProductionVariant objects.
void	setTagsRaw(List<CfnTag> value)	A list of key-value pairs to apply to this resource.
void	setVpcConfig(IResolvable value)
void	setVpcConfig(CfnEndpointConfig.VpcConfigProperty value)

Methods inherited from class software.amazon.awscdk.CfnResource

addDeletionOverride, addDependency, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getAtt, getCfnOptions, getCfnResourceType, getEnv, getMetadata, getUpdatedProperites, getUpdatedProperties, isCfnResource, obtainDependencies, obtainResourceDependencies, removeDependency, replaceDependency, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.constructs.Construct

getNode, isConstruct

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.interfaces.IEnvironmentAware

getEnv

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

CFN_RESOURCE_TYPE_NAME

@Stability(Stable)
public static final String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Details

CfnEndpointConfig

protected CfnEndpointConfig(software.amazon.jsii.JsiiObjectRef objRef)

CfnEndpointConfig

protected CfnEndpointConfig(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

CfnEndpointConfig

@Stability(Stable)
public CfnEndpointConfig(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 CfnEndpointConfigProps props)

Create a new AWS::SageMaker::EndpointConfig.

Parameters:

scope - Scope in which this resource is defined. This parameter is required.

id - Construct identifier for this resource (unique in its scope). This parameter is required.

props - Resource properties. This parameter is required.

Method Details

inspect

@Stability(Stable)
public void inspect(@NotNull
 TreeInspector inspector)

Examines the CloudFormation resource and discloses attributes.

Specified by:

inspect in interface IInspectable

Parameters:

inspector - tree inspector to collect and process attributes. This parameter is required.

renderProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> renderProperties(@NotNull
 Map<String,Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getAttrEndpointConfigName

@Stability(Stable)
@NotNull
public String getAttrEndpointConfigName()

The name of the endpoint configuration, such as MyEndpointConfiguration .

getAttrId

@Stability(Stable)
@NotNull
public String getAttrId()

getCfnProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getEndpointConfigRef

@Stability(Stable)
@NotNull
public EndpointConfigReference getEndpointConfigRef()

A reference to a EndpointConfig resource.

Specified by:

getEndpointConfigRef in interface IEndpointConfigRef

getTags

@Stability(Stable)
@NotNull
public TagManager getTags()

Tag Manager which manages the tags for this resource.

Specified by:

getTags in interface ITaggable

getProductionVariants

@Stability(Stable)
@NotNull
public Object getProductionVariants()

A list of ProductionVariant objects, one for each model that you want to host at this endpoint.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnEndpointConfig.ProductionVariantProperty>

setProductionVariants

@Stability(Stable)
public void setProductionVariants(@NotNull
 IResolvable value)

A list of ProductionVariant objects, one for each model that you want to host at this endpoint.

setProductionVariants

@Stability(Stable)
public void setProductionVariants(@NotNull
 List<Object> value)

A list of ProductionVariant objects, one for each model that you want to host at this endpoint.

getAsyncInferenceConfig

@Stability(Stable)
@Nullable
public Object getAsyncInferenceConfig()

Specifies configuration for how an endpoint performs asynchronous inference.

Returns union: either IResolvable or CfnEndpointConfig.AsyncInferenceConfigProperty

setAsyncInferenceConfig

@Stability(Stable)
public void setAsyncInferenceConfig(@Nullable
 IResolvable value)

Specifies configuration for how an endpoint performs asynchronous inference.

setAsyncInferenceConfig

@Stability(Stable)
public void setAsyncInferenceConfig(@Nullable
 CfnEndpointConfig.AsyncInferenceConfigProperty value)

Specifies configuration for how an endpoint performs asynchronous inference.

getDataCaptureConfig

@Stability(Stable)
@Nullable
public Object getDataCaptureConfig()

Specifies how to capture endpoint data for model monitor.

Returns union: either IResolvable or CfnEndpointConfig.DataCaptureConfigProperty

setDataCaptureConfig

@Stability(Stable)
public void setDataCaptureConfig(@Nullable
 IResolvable value)

Specifies how to capture endpoint data for model monitor.

setDataCaptureConfig

@Stability(Stable)
public void setDataCaptureConfig(@Nullable
 CfnEndpointConfig.DataCaptureConfigProperty value)

Specifies how to capture endpoint data for model monitor.

getEnableNetworkIsolation

@Stability(Stable)
@Nullable
public Object getEnableNetworkIsolation()

Returns union: either Boolean or IResolvable

setEnableNetworkIsolation

@Stability(Stable)
public void setEnableNetworkIsolation(@Nullable
 Boolean value)

setEnableNetworkIsolation

@Stability(Stable)
public void setEnableNetworkIsolation(@Nullable
 IResolvable value)

getEndpointConfigName

@Stability(Stable)
@Nullable
public String getEndpointConfigName()

The name of the endpoint configuration.

setEndpointConfigName

@Stability(Stable)
public void setEndpointConfigName(@Nullable
 String value)

The name of the endpoint configuration.

getExecutionRoleArn

@Stability(Stable)
@Nullable
public String getExecutionRoleArn()

setExecutionRoleArn

@Stability(Stable)
public void setExecutionRoleArn(@Nullable
 String value)

getExplainerConfig

@Stability(Stable)
@Nullable
public Object getExplainerConfig()

A parameter to activate explainers.

Returns union: either IResolvable or CfnEndpointConfig.ExplainerConfigProperty

setExplainerConfig

@Stability(Stable)
public void setExplainerConfig(@Nullable
 IResolvable value)

A parameter to activate explainers.

setExplainerConfig

@Stability(Stable)
public void setExplainerConfig(@Nullable
 CfnEndpointConfig.ExplainerConfigProperty value)

A parameter to activate explainers.

getKmsKeyId

@Stability(Stable)
@Nullable
public String getKmsKeyId()

The Amazon Resource Name (ARN) of an AWS Key Management Service key that Amazon SageMaker uses to encrypt data on the storage volume attached to the ML compute instance that hosts the endpoint.

setKmsKeyId

@Stability(Stable)
public void setKmsKeyId(@Nullable
 String value)

The Amazon Resource Name (ARN) of an AWS Key Management Service key that Amazon SageMaker uses to encrypt data on the storage volume attached to the ML compute instance that hosts the endpoint.

getShadowProductionVariants

@Stability(Stable)
@Nullable
public Object getShadowProductionVariants()

Array of ProductionVariant objects.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnEndpointConfig.ProductionVariantProperty>

setShadowProductionVariants

@Stability(Stable)
public void setShadowProductionVariants(@Nullable
 IResolvable value)

Array of ProductionVariant objects.

setShadowProductionVariants

@Stability(Stable)
public void setShadowProductionVariants(@Nullable
 List<Object> value)

Array of ProductionVariant objects.

getTagsRaw

@Stability(Stable)
@Nullable
public List<CfnTag> getTagsRaw()

A list of key-value pairs to apply to this resource.

setTagsRaw

@Stability(Stable)
public void setTagsRaw(@Nullable
 List<CfnTag> value)

A list of key-value pairs to apply to this resource.

getVpcConfig

@Stability(Stable)
@Nullable
public Object getVpcConfig()

Returns union: either IResolvable or CfnEndpointConfig.VpcConfigProperty

setVpcConfig

@Stability(Stable)
public void setVpcConfig(@Nullable
 IResolvable value)

setVpcConfig

@Stability(Stable)
public void setVpcConfig(@Nullable
 CfnEndpointConfig.VpcConfigProperty value)