AWS::SageMaker::InferenceExperiment - AWS CloudFormation
SyntaxPropertiesReturn values

AWS::SageMaker::InferenceExperiment

Creates an inference experiment using the configurations specified in the request.

Use this API to setup and schedule an experiment to compare model variants on a Amazon SageMaker inference endpoint. For more information about inference experiments, see Shadow tests.

Amazon SageMaker begins your experiment at the scheduled time and routes traffic to your endpoint's model variants based on your specified configuration.

While the experiment is in progress or after it has concluded, you can view metrics that compare your model variants. For more information, see View, monitor, and edit shadow tests.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::SageMaker::InferenceExperiment",
  "Properties" : {
      "DataStorageConfig" : DataStorageConfig,
      "Description" : String,
      "DesiredState" : String,
      "EndpointName" : String,
      "KmsKey" : String,
      "ModelVariants" : [ ModelVariantConfig, ... ],
      "Name" : String,
      "RoleArn" : String,
      "Schedule" : InferenceExperimentSchedule,
      "ShadowModeConfig" : ShadowModeConfig,
      "StatusReason" : String,
      "Tags" : [ Tag, ... ],
      "Type" : String
    }
}

YAML

Type: AWS::SageMaker::InferenceExperiment
Properties: 
  DataStorageConfig: 
    DataStorageConfig
  Description: String
  DesiredState: String
  EndpointName: String
  KmsKey: String
  ModelVariants: 
    - ModelVariantConfig
  Name: String
  RoleArn: String
  Schedule: 
    InferenceExperimentSchedule
  ShadowModeConfig: 
    ShadowModeConfig
  StatusReason: String
  Tags: 
    - Tag
  Type: String

Properties

DataStorageConfig

Property description not available.

Required: No

Type: DataStorageConfig

Update requires: No interruption

Description

The description of the inference experiment.

Required: No

Type: String

Maximum: 1024

Pattern: .*

Update requires: No interruption

DesiredState

Property description not available.

Required: No

Type: String

Update requires: No interruption

EndpointName

Property description not available.

Required: Yes

Type: String

Update requires: Replacement

KmsKey

The AWS Key Management Service key that Amazon SageMaker uses to encrypt captured data at rest using Amazon S3 server-side encryption.

Required: No

Type: String

Maximum: 2048

Pattern: .*

Update requires: Replacement

ModelVariants

Property description not available.

Required: Yes

Type: List of ModelVariantConfig

Update requires: No interruption

Name

The name of the inference experiment.

Required: Yes

Type: String

Minimum: 1

Maximum: 120

Pattern: ^[a-zA-Z0-9](-*[a-zA-Z0-9]){0,119}

Update requires: Replacement

RoleArn

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.

Required: Yes

Type: String

Minimum: 20

Maximum: 2048

Pattern: ^arn:aws[a-z\-]*:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+$

Update requires: Replacement

Schedule

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.

Required: No

Type: InferenceExperimentSchedule

Update requires: No interruption

ShadowModeConfig

Property description not available.

Required: No

Type: ShadowModeConfig

Update requires: No interruption

StatusReason

The error message for the inference experiment status result.

Required: No

Type: String

Maximum: 1024

Pattern: .*

Update requires: No interruption

Tags

Property description not available.

Required: No

Type: List of Tag

Update requires: No interruption

Type

The type of the inference experiment.

Required: Yes

Type: String

Allowed values: ShadowMode

Update requires: Replacement

Return values

Ref

Fn::GetAtt

Arn

Property description not available.

CreationTime

Property description not available.

EndpointMetadata

Property description not available.

EndpointMetadata.EndpointConfigName

Property description not available.

EndpointMetadata.EndpointName

Property description not available.

EndpointMetadata.EndpointStatus

Property description not available.

LastModifiedTime

Property description not available.

Status

Property description not available.