Package software.amazon.awscdk.services.sagemaker

Class CfnModelCard

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.CfnModelCard

All Implemented Interfaces:

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

@Generated(value="jsii-pacmak/1.121.0 (build d7af9b9)",
           date="2025-12-18T18:20:17.456Z")
@Stability(Stable)
public class CfnModelCard
extends CfnResource
implements IInspectable, IModelCardRef, ITaggable

Creates an Amazon SageMaker Model Card.

For information about how to use model cards, see Amazon SageMaker Model Card .

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.*;
 Object value;
 CfnModelCard cfnModelCard = CfnModelCard.Builder.create(this, "MyCfnModelCard")
         .content(ContentProperty.builder()
                 .additionalInformation(AdditionalInformationProperty.builder()
                         .caveatsAndRecommendations("caveatsAndRecommendations")
                         .customDetails(Map.of(
                                 "customDetailsKey", "customDetails"))
                         .ethicalConsiderations("ethicalConsiderations")
                         .build())
                 .businessDetails(BusinessDetailsProperty.builder()
                         .businessProblem("businessProblem")
                         .businessStakeholders("businessStakeholders")
                         .lineOfBusiness("lineOfBusiness")
                         .build())
                 .evaluationDetails(List.of(EvaluationDetailProperty.builder()
                         .name("name")
                         // the properties below are optional
                         .datasets(List.of("datasets"))
                         .evaluationJobArn("evaluationJobArn")
                         .evaluationObservation("evaluationObservation")
                         .metadata(Map.of(
                                 "metadataKey", "metadata"))
                         .metricGroups(List.of(MetricGroupProperty.builder()
                                 .metricData(List.of(MetricDataItemsProperty.builder()
                                         .name("name")
                                         .type("type")
                                         .value(value)
                                         // the properties below are optional
                                         .notes("notes")
                                         .xAxisName(List.of("xAxisName"))
                                         .yAxisName(List.of("yAxisName"))
                                         .build()))
                                 .name("name")
                                 .build()))
                         .build()))
                 .intendedUses(IntendedUsesProperty.builder()
                         .explanationsForRiskRating("explanationsForRiskRating")
                         .factorsAffectingModelEfficiency("factorsAffectingModelEfficiency")
                         .intendedUses("intendedUses")
                         .purposeOfModel("purposeOfModel")
                         .riskRating("riskRating")
                         .build())
                 .modelOverview(ModelOverviewProperty.builder()
                         .algorithmType("algorithmType")
                         .inferenceEnvironment(InferenceEnvironmentProperty.builder()
                                 .containerImage(List.of("containerImage"))
                                 .build())
                         .modelArtifact(List.of("modelArtifact"))
                         .modelCreator("modelCreator")
                         .modelDescription("modelDescription")
                         .modelId("modelId")
                         .modelName("modelName")
                         .modelOwner("modelOwner")
                         .modelVersion(123)
                         .problemType("problemType")
                         .build())
                 .modelPackageDetails(ModelPackageDetailsProperty.builder()
                         .approvalDescription("approvalDescription")
                         .createdBy(ModelPackageCreatorProperty.builder()
                                 .userProfileName("userProfileName")
                                 .build())
                         .domain("domain")
                         .inferenceSpecification(InferenceSpecificationProperty.builder()
                                 .containers(List.of(ContainerProperty.builder()
                                         .image("image")
                                         // the properties below are optional
                                         .modelDataUrl("modelDataUrl")
                                         .nearestModelName("nearestModelName")
                                         .build()))
                                 .build())
                         .modelApprovalStatus("modelApprovalStatus")
                         .modelPackageArn("modelPackageArn")
                         .modelPackageDescription("modelPackageDescription")
                         .modelPackageGroupName("modelPackageGroupName")
                         .modelPackageName("modelPackageName")
                         .modelPackageStatus("modelPackageStatus")
                         .modelPackageVersion(123)
                         .sourceAlgorithms(List.of(SourceAlgorithmProperty.builder()
                                 .algorithmName("algorithmName")
                                 // the properties below are optional
                                 .modelDataUrl("modelDataUrl")
                                 .build()))
                         .task("task")
                         .build())
                 .trainingDetails(TrainingDetailsProperty.builder()
                         .objectiveFunction(ObjectiveFunctionProperty.builder()
                                 .function(FunctionProperty.builder()
                                         .condition("condition")
                                         .facet("facet")
                                         .function("function")
                                         .build())
                                 .notes("notes")
                                 .build())
                         .trainingJobDetails(TrainingJobDetailsProperty.builder()
                                 .hyperParameters(List.of(TrainingHyperParameterProperty.builder()
                                         .name("name")
                                         .value("value")
                                         .build()))
                                 .trainingArn("trainingArn")
                                 .trainingDatasets(List.of("trainingDatasets"))
                                 .trainingEnvironment(TrainingEnvironmentProperty.builder()
                                         .containerImage(List.of("containerImage"))
                                         .build())
                                 .trainingMetrics(List.of(TrainingMetricProperty.builder()
                                         .name("name")
                                         .value(123)
                                         // the properties below are optional
                                         .notes("notes")
                                         .build()))
                                 .userProvidedHyperParameters(List.of(TrainingHyperParameterProperty.builder()
                                         .name("name")
                                         .value("value")
                                         .build()))
                                 .userProvidedTrainingMetrics(List.of(TrainingMetricProperty.builder()
                                         .name("name")
                                         .value(123)
                                         // the properties below are optional
                                         .notes("notes")
                                         .build()))
                                 .build())
                         .trainingObservations("trainingObservations")
                         .build())
                 .build())
         .modelCardName("modelCardName")
         .modelCardStatus("modelCardStatus")
         // the properties below are optional
         .createdBy(UserContextProperty.builder()
                 .domainId("domainId")
                 .userProfileArn("userProfileArn")
                 .userProfileName("userProfileName")
                 .build())
         .lastModifiedBy(UserContextProperty.builder()
                 .domainId("domainId")
                 .userProfileArn("userProfileArn")
                 .userProfileName("userProfileName")
                 .build())
         .securityConfig(SecurityConfigProperty.builder()
                 .kmsKeyId("kmsKeyId")
                 .build())
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();
 

See Also:

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CfnModelCard.AdditionalInformationProperty	Additional information about the model.
static final class	CfnModelCard.Builder	A fluent builder for CfnModelCard.
static interface	CfnModelCard.BusinessDetailsProperty	Information about how the model supports business goals.
static interface	CfnModelCard.ContainerProperty	Example:
static interface	CfnModelCard.ContentProperty	The content of the model card.
static interface	CfnModelCard.EvaluationDetailProperty	The evaluation details of the model.
static interface	CfnModelCard.FunctionProperty	Function details.
static interface	CfnModelCard.InferenceEnvironmentProperty	An overview of a model's inference environment.
static interface	CfnModelCard.InferenceSpecificationProperty	Defines how to perform inference generation after a training job is run.
static interface	CfnModelCard.IntendedUsesProperty	The intended uses of a model.
static interface	CfnModelCard.MetricDataItemsProperty	Metric data.
static interface	CfnModelCard.MetricGroupProperty	A group of metric data that you use to initialize a metric group object.
static interface	CfnModelCard.ModelOverviewProperty	An overview about the model.
static interface	CfnModelCard.ModelPackageCreatorProperty	Example:
static interface	CfnModelCard.ModelPackageDetailsProperty	Metadata information related to model package version.
static interface	CfnModelCard.ObjectiveFunctionProperty	The function that is optimized during model training.
static interface	CfnModelCard.SecurityConfigProperty	The security configuration used to protect model card data.
static interface	CfnModelCard.SourceAlgorithmProperty	Specifies an algorithm that was used to create the model package.
static interface	CfnModelCard.TrainingDetailsProperty	The training details of the model.
static interface	CfnModelCard.TrainingEnvironmentProperty	SageMaker AI training image.
static interface	CfnModelCard.TrainingHyperParameterProperty	A hyper parameter that was configured in training the model.
static interface	CfnModelCard.TrainingJobDetailsProperty	The overview of a training job.
static interface	CfnModelCard.TrainingMetricProperty	A result from a SageMaker AI training job.
static interface	CfnModelCard.UserContextProperty	Information about the user who created or modified a SageMaker resource.

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.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

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

IModelCardRef.Jsii$Default, IModelCardRef.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	CfnModelCard(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnModelCard(software.amazon.jsii.JsiiObjectRef objRef)
	CfnModelCard(software.constructs.Construct scope, String id, CfnModelCardProps props)	Create a new AWS::SageMaker::ModelCard.

Method Summary

Modifier and Type	Method	Description
static String	arnForModelCard(IModelCardRef resource)
static IModelCardRef	fromModelCardArn(software.constructs.Construct scope, String id, String arn)	Creates a new IModelCardRef from an ARN.
static IModelCardRef	fromModelCardName(software.constructs.Construct scope, String id, String modelCardName)	Creates a new IModelCardRef from a modelCardName.
String	getAttrCreatedByDomainId()	The domain associated with the user.
String	getAttrCreatedByUserProfileArn()	The Amazon Resource Name (ARN) of the user's profile.
String	getAttrCreatedByUserProfileName()	The name of the user's profile.
String	getAttrCreationTime()	The date and time the model card was created.
String	getAttrLastModifiedByDomainId()	The domain associated with the user.
String	getAttrLastModifiedByUserProfileArn()	The Amazon Resource Name (ARN) of the user's profile.
String	getAttrLastModifiedByUserProfileName()	The name of the user's profile.
String	getAttrLastModifiedTime()	The date and time the model card was last modified.
String	getAttrModelCardArn()	The Amazon Resource Number (ARN) of the model card.
String	getAttrModelCardProcessingStatus()	The processing status of model card deletion.
Number	getAttrModelCardVersion()	A version of the model card.
protected Map<String,Object>	getCfnProperties()
Object	getContent()	The content of the model card.
Object	getCreatedBy()	Information about the user who created or modified one or more of the following:.
Object	getLastModifiedBy()	Information about the user who created or modified an experiment, trial, trial component, lineage group, project, or model card.
String	getModelCardName()	The unique name of the model card.
ModelCardReference	getModelCardRef()	A reference to a ModelCard resource.
String	getModelCardStatus()	The approval status of the model card within your organization.
Object	getSecurityConfig()	The security configuration used to protect model card data.
TagManager	getTags()	Tag Manager which manages the tags for this resource.
List<CfnTag>	getTagsRaw()	Key-value pairs used to manage metadata for the model card.
void	inspect(TreeInspector inspector)	Examines the CloudFormation resource and discloses attributes.
static Boolean	isCfnModelCard(Object x)	Checks whether the given object is a CfnModelCard.
protected Map<String,Object>	renderProperties(Map<String,Object> props)
void	setContent(IResolvable value)	The content of the model card.
void	setContent(CfnModelCard.ContentProperty value)	The content of the model card.
void	setCreatedBy(IResolvable value)	Information about the user who created or modified one or more of the following:.
void	setCreatedBy(CfnModelCard.UserContextProperty value)	Information about the user who created or modified one or more of the following:.
void	setLastModifiedBy(IResolvable value)	Information about the user who created or modified an experiment, trial, trial component, lineage group, project, or model card.
void	setLastModifiedBy(CfnModelCard.UserContextProperty value)	Information about the user who created or modified an experiment, trial, trial component, lineage group, project, or model card.
void	setModelCardName(String value)	The unique name of the model card.
void	setModelCardStatus(String value)	The approval status of the model card within your organization.
void	setSecurityConfig(IResolvable value)	The security configuration used to protect model card data.
void	setSecurityConfig(CfnModelCard.SecurityConfigProperty value)	The security configuration used to protect model card data.
void	setTagsRaw(List<CfnTag> value)	Key-value pairs used to manage metadata for the model card.

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

CfnModelCard

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

CfnModelCard

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

CfnModelCard

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

Create a new AWS::SageMaker::ModelCard.

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

arnForModelCard

@Stability(Stable)
@NotNull
public static String arnForModelCard(@NotNull
 IModelCardRef resource)

Parameters:

resource - This parameter is required.

fromModelCardArn

@Stability(Stable)
@NotNull
public static IModelCardRef fromModelCardArn(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 String arn)

Creates a new IModelCardRef from an ARN.

Parameters:

scope - This parameter is required.

id - This parameter is required.

arn - This parameter is required.

fromModelCardName

@Stability(Stable)
@NotNull
public static IModelCardRef fromModelCardName(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 String modelCardName)

Creates a new IModelCardRef from a modelCardName.

Parameters:

scope - This parameter is required.

id - This parameter is required.

modelCardName - This parameter is required.

isCfnModelCard

@Stability(Stable)
@NotNull
public static Boolean isCfnModelCard(@NotNull
 Object x)

Checks whether the given object is a CfnModelCard.

Parameters:

x - This parameter is required.

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.

getAttrCreatedByDomainId

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

The domain associated with the user.

getAttrCreatedByUserProfileArn

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

The Amazon Resource Name (ARN) of the user's profile.

getAttrCreatedByUserProfileName

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

The name of the user's profile.

getAttrCreationTime

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

The date and time the model card was created.

getAttrLastModifiedByDomainId

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

The domain associated with the user.

getAttrLastModifiedByUserProfileArn

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

The Amazon Resource Name (ARN) of the user's profile.

getAttrLastModifiedByUserProfileName

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

The name of the user's profile.

getAttrLastModifiedTime

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

The date and time the model card was last modified.

getAttrModelCardArn

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

The Amazon Resource Number (ARN) of the model card.

For example, arn:aws:sagemaker:us-west-2:012345678901:modelcard/examplemodelcard .

getAttrModelCardProcessingStatus

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

The processing status of model card deletion.

The ModelCardProcessingStatus updates throughout the different deletion steps.

getAttrModelCardVersion

@Stability(Stable)
@NotNull
public Number getAttrModelCardVersion()

A version of the model card.

getCfnProperties

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

Overrides:

getCfnProperties in class CfnResource

getModelCardRef

@Stability(Stable)
@NotNull
public ModelCardReference getModelCardRef()

A reference to a ModelCard resource.

Specified by:

getModelCardRef in interface IModelCardRef

getTags

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

Tag Manager which manages the tags for this resource.

Specified by:

getTags in interface ITaggable

getContent

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

The content of the model card.

Returns union: either IResolvable or CfnModelCard.ContentProperty

setContent

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

The content of the model card.

setContent

@Stability(Stable)
public void setContent(@NotNull
 CfnModelCard.ContentProperty value)

The content of the model card.

getModelCardName

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

The unique name of the model card.

setModelCardName

@Stability(Stable)
public void setModelCardName(@NotNull
 String value)

The unique name of the model card.

getModelCardStatus

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

The approval status of the model card within your organization.

setModelCardStatus

@Stability(Stable)
public void setModelCardStatus(@NotNull
 String value)

The approval status of the model card within your organization.

getCreatedBy

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

Information about the user who created or modified one or more of the following:.

Returns union: either IResolvable or CfnModelCard.UserContextProperty

setCreatedBy

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

Information about the user who created or modified one or more of the following:.

setCreatedBy

@Stability(Stable)
public void setCreatedBy(@Nullable
 CfnModelCard.UserContextProperty value)

Information about the user who created or modified one or more of the following:.

getLastModifiedBy

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

Information about the user who created or modified an experiment, trial, trial component, lineage group, project, or model card.

Returns union: either IResolvable or CfnModelCard.UserContextProperty

setLastModifiedBy

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

Information about the user who created or modified an experiment, trial, trial component, lineage group, project, or model card.

setLastModifiedBy

@Stability(Stable)
public void setLastModifiedBy(@Nullable
 CfnModelCard.UserContextProperty value)

Information about the user who created or modified an experiment, trial, trial component, lineage group, project, or model card.

getSecurityConfig

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

The security configuration used to protect model card data.

Returns union: either IResolvable or CfnModelCard.SecurityConfigProperty

setSecurityConfig

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

The security configuration used to protect model card data.

setSecurityConfig

@Stability(Stable)
public void setSecurityConfig(@Nullable
 CfnModelCard.SecurityConfigProperty value)

The security configuration used to protect model card data.

getTagsRaw

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

Key-value pairs used to manage metadata for the model card.

setTagsRaw

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

Key-value pairs used to manage metadata for the model card.