Skip to content
v2.273.0

CfnInferenceExperimentProps Struct ​

Properties for defining a CfnInferenceExperiment.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_sagemaker as sagemaker } from 'aws-cdk-lib';
const cfnInferenceExperimentProps: sagemaker.CfnInferenceExperimentProps = {
  endpointName: 'endpointName',
  modelVariants: [{
    infrastructureConfig: {
      infrastructureType: 'infrastructureType',
      realTimeInferenceConfig: {
        instanceCount: 123,
        instanceType: 'instanceType',
      },
    },
    modelName: 'modelName',
    variantName: 'variantName',
  }],
  name: 'name',
  roleArn: 'roleArn',
  type: 'type',

  // the properties below are optional
  dataStorageConfig: {
    destination: 'destination',

    // the properties below are optional
    contentType: {
      csvContentTypes: ['csvContentTypes'],
      jsonContentTypes: ['jsonContentTypes'],
    },
    kmsKey: 'kmsKey',
  },
  description: 'description',
  desiredState: 'desiredState',
  kmsKey: 'kmsKey',
  schedule: {
    endTime: 'endTime',
    startTime: 'startTime',
  },
  shadowModeConfig: {
    shadowModelVariants: [{
      samplingPercentage: 123,
      shadowModelVariantName: 'shadowModelVariantName',
    }],
    sourceModelVariantName: 'sourceModelVariantName',
  },
  statusReason: 'statusReason',
  tags: [{
    key: 'key',
    value: 'value',
  }],
};

Properties ​

dataStorageConfigIResolvable | CfnInferenceExperiment.DataStorageConfigPropertydata_storage_configtyping.Union[IResolvable, DataStorageConfigProperty]dataStorageConfigIResolvableDataStorageConfigIResolvableDataStorageConfiginterface{}#
The Amazon S3 location and configuration for storing inference request and response data.
descriptionstringdescriptionstrdescriptionStringDescriptionstringDescription*string#
The description of the inference experiment.
desiredStatestringdesired_statestrdesiredStateStringDesiredStatestringDesiredState*string#
The desired state of the experiment after stopping. The possible states are the following:.
  • Completed : The experiment completed successfully
  • Cancelled : The experiment was canceled
endpointNamestringendpoint_namestrendpointNameStringEndpointNamestringEndpointName*stringrequired#
The name of the endpoint.
kmsKeystringkms_keystrkmsKeyStringKmsKeystringKmsKey*string#
The AWS Key Management Service key that Amazon SageMaker uses to encrypt captured data at rest using Amazon S3 server-side encryption.
modelVariantsIResolvable | IResolvable | CfnInferenceExperiment.ModelVariantConfigProperty[]model_variantstyping.Union[IResolvable, typing.List[typing.Union[IResolvable, ModelVariantConfigProperty]]]modelVariantsIResolvableModelVariantsIResolvableModelVariantsinterface{}required#
An array of `ModelVariantConfigSummary` objects.

There is one for each variant in the inference experiment. Each ModelVariantConfigSummary object in the array describes the infrastructure configuration for deploying the corresponding variant.

namestringnamestrnameStringNamestringName*stringrequired#
The name of the inference experiment.
roleArnstringrole_arnstrroleArnStringRoleArnstringRoleArn*stringrequired#
The ARN of the IAM role that Amazon SageMaker can assume to access model artifacts and container images, and manage Amazon SageMaker Inference endpoints for model deployment.
The duration for which the inference experiment ran or will run.

The maximum duration that you can set for an inference experiment is 30 days.

shadowModeConfigIResolvable | CfnInferenceExperiment.ShadowModeConfigPropertyshadow_mode_configtyping.Union[IResolvable, ShadowModeConfigProperty]shadowModeConfigIResolvableShadowModeConfigIResolvableShadowModeConfiginterface{}#
The configuration of `ShadowMode` inference experiment type, which shows the production variant that takes all the inference requests, and the shadow variant to which Amazon SageMaker replicates a percentage of the inference requests.

For the shadow variant it also shows the percentage of requests that Amazon SageMaker replicates.

statusReasonstringstatus_reasonstrstatusReasonStringStatusReasonstringStatusReason*string#
The error message for the inference experiment status result.
tagsCfnTag[]tagstyping.List[CfnTag]tagsList<CfnTag>TagsCfnTag[]Tags*[]CfnTag#
An array of key-value pairs to apply to this resource.

For more information, see Tag .

typestringtypestrtypeStringTypestringType*stringrequired#
The type of the inference experiment.

Used as props by ​