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