The name of the model compilation job.
* @public */ CompilationJobName: string | undefined; /** *The Amazon Resource Name (ARN) of the model compilation job.
* @public */ CompilationJobArn: string | undefined; /** *The status of the model compilation job.
* @public */ CompilationJobStatus: CompilationJobStatus | undefined; /** *The time when the model compilation job started the CompilationJob instances.
You are billed for the time between this timestamp and the timestamp in the CompilationEndTime field. In Amazon CloudWatch Logs, the start time might be later than this time. That's because it takes time to download the compilation job, which depends on the size of the compilation job container.
The time when the model compilation job on a compilation job instance ended. For a successful or stopped job, this is when the job's model artifacts have finished uploading. For a failed job, this is when Amazon SageMaker AI detected that the job failed.
* @public */ CompilationEndTime?: Date | undefined; /** *Specifies a limit to how long a model compilation job can run. When the job reaches the time limit, Amazon SageMaker AI ends the compilation job. Use this API to cap model training costs.
* @public */ StoppingCondition: StoppingCondition | undefined; /** *The inference image to use when compiling a model. Specify an image only if the target device is a cloud instance.
* @public */ InferenceImage?: string | undefined; /** *The Amazon Resource Name (ARN) of the versioned model package that was provided to SageMaker Neo when you initiated a compilation job.
* @public */ ModelPackageVersionArn?: string | undefined; /** *The time that the model compilation job was created.
* @public */ CreationTime: Date | undefined; /** *The time that the status of the model compilation job was last modified.
* @public */ LastModifiedTime: Date | undefined; /** *If a model compilation job failed, the reason it failed.
* @public */ FailureReason: string | undefined; /** *Information about the location in Amazon S3 that has been configured for storing the model artifacts used in the compilation job.
* @public */ ModelArtifacts: ModelArtifacts | undefined; /** *Provides a BLAKE2 hash value that identifies the compiled model artifacts in Amazon S3.
* @public */ ModelDigests?: ModelDigests | undefined; /** *The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker AI assumes to perform the model compilation job.
* @public */ RoleArn: string | undefined; /** *Information about the location in Amazon S3 of the input model artifacts, the name and shape of the expected data inputs, and the framework in which the model was trained.
* @public */ InputConfig: InputConfig | undefined; /** *Information about the output location for the compiled model and the target device that the model runs on.
* @public */ OutputConfig: OutputConfig | undefined; /** *A VpcConfig object that specifies the VPC that you want your compilation job to connect to. Control access to your models by configuring the VPC. For more information, see Protect Compilation Jobs by Using an Amazon Virtual Private Cloud.
* @public */ VpcConfig?: NeoVpcConfig | undefined; /** *Information that SageMaker Neo automatically derived about the model.
* @public */ DerivedInformation?: DerivedInformation | undefined; } /** * @public */ export interface DescribeComputeQuotaRequest { /** *ID of the compute allocation definition.
* @public */ ComputeQuotaId: string | undefined; /** *Version of the compute allocation definition.
* @public */ ComputeQuotaVersion?: number | undefined; } /** * @public */ export interface DescribeComputeQuotaResponse { /** *ARN of the compute allocation definition.
* @public */ ComputeQuotaArn: string | undefined; /** *ID of the compute allocation definition.
* @public */ ComputeQuotaId: string | undefined; /** *Name of the compute allocation definition.
* @public */ Name: string | undefined; /** *Description of the compute allocation definition.
* @public */ Description?: string | undefined; /** *Version of the compute allocation definition.
* @public */ ComputeQuotaVersion: number | undefined; /** *Status of the compute allocation definition.
* @public */ Status: SchedulerResourceStatus | undefined; /** *Failure reason of the compute allocation definition.
* @public */ FailureReason?: string | undefined; /** *ARN of the cluster.
* @public */ ClusterArn?: string | undefined; /** *Configuration of the compute allocation definition. This includes the resource sharing option, and the setting to preempt low priority tasks.
* @public */ ComputeQuotaConfig?: ComputeQuotaConfig | undefined; /** *The target entity to allocate compute resources to.
* @public */ ComputeQuotaTarget: ComputeQuotaTarget | undefined; /** *The state of the compute allocation being described. Use to enable or disable compute allocation.
Default is Enabled.
Creation time of the compute allocation configuration.
* @public */ CreationTime: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy?: UserContext | undefined; /** *Last modified time of the compute allocation configuration.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; } /** * @public */ export interface DescribeContextRequest { /** *The name of the context to describe.
* @public */ ContextName: string | undefined; } /** * @public */ export interface DescribeContextResponse { /** *The name of the context.
* @public */ ContextName?: string | undefined; /** *The Amazon Resource Name (ARN) of the context.
* @public */ ContextArn?: string | undefined; /** *The source of the context.
* @public */ Source?: ContextSource | undefined; /** *The type of the context.
* @public */ ContextType?: string | undefined; /** *The description of the context.
* @public */ Description?: string | undefined; /** *A list of the context's properties.
* @public */ Properties?: RecordWhen the context was created.
* @public */ CreationTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy?: UserContext | undefined; /** *When the context was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; /** *The Amazon Resource Name (ARN) of the lineage group.
* @public */ LineageGroupArn?: string | undefined; } /** * @public */ export interface DescribeDataQualityJobDefinitionRequest { /** *The name of the data quality monitoring job definition to describe.
* @public */ JobDefinitionName: string | undefined; } /** * @public */ export interface DescribeDataQualityJobDefinitionResponse { /** *The Amazon Resource Name (ARN) of the data quality monitoring job definition.
* @public */ JobDefinitionArn: string | undefined; /** *The name of the data quality monitoring job definition.
* @public */ JobDefinitionName: string | undefined; /** *The time that the data quality monitoring job definition was created.
* @public */ CreationTime: Date | undefined; /** *The constraints and baselines for the data quality monitoring job definition.
* @public */ DataQualityBaselineConfig?: DataQualityBaselineConfig | undefined; /** *Information about the container that runs the data quality monitoring job.
* @public */ DataQualityAppSpecification: DataQualityAppSpecification | undefined; /** *The list of inputs for the data quality monitoring job. Currently endpoints are supported.
* @public */ DataQualityJobInput: DataQualityJobInput | undefined; /** *The output configuration for monitoring jobs.
* @public */ DataQualityJobOutputConfig: MonitoringOutputConfig | undefined; /** *Identifies the resources to deploy for a monitoring job.
* @public */ JobResources: MonitoringResources | undefined; /** *The networking configuration for the data quality monitoring job.
* @public */ NetworkConfig?: MonitoringNetworkConfig | undefined; /** *The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker AI can assume to perform tasks on your behalf.
* @public */ RoleArn: string | undefined; /** *A time limit for how long the monitoring job is allowed to run before stopping.
* @public */ StoppingCondition?: MonitoringStoppingCondition | undefined; } /** * @public */ export interface DescribeDeviceRequest { /** *Next token of device description.
* @public */ NextToken?: string | undefined; /** *The unique ID of the device.
* @public */ DeviceName: string | undefined; /** *The name of the fleet the devices belong to.
* @public */ DeviceFleetName: string | undefined; } /** *The model on the edge device.
* @public */ export interface EdgeModel { /** *The name of the model.
* @public */ ModelName: string | undefined; /** *The model version.
* @public */ ModelVersion: string | undefined; /** *The timestamp of the last data sample taken.
* @public */ LatestSampleTime?: Date | undefined; /** *The timestamp of the last inference that was made.
* @public */ LatestInference?: Date | undefined; } /** * @public */ export interface DescribeDeviceResponse { /** *The Amazon Resource Name (ARN) of the device.
* @public */ DeviceArn?: string | undefined; /** *The unique identifier of the device.
* @public */ DeviceName: string | undefined; /** *A description of the device.
* @public */ Description?: string | undefined; /** *The name of the fleet the device belongs to.
* @public */ DeviceFleetName: string | undefined; /** *The Amazon Web Services Internet of Things (IoT) object thing name associated with the device.
* @public */ IotThingName?: string | undefined; /** *The timestamp of the last registration or de-reregistration.
* @public */ RegistrationTime: Date | undefined; /** *The last heartbeat received from the device.
* @public */ LatestHeartbeat?: Date | undefined; /** *Models on the device.
* @public */ Models?: EdgeModel[] | undefined; /** *The maximum number of models.
* @public */ MaxModels?: number | undefined; /** *The response from the last list when returning a list large enough to need tokening.
* @public */ NextToken?: string | undefined; /** *Edge Manager agent version.
* @public */ AgentVersion?: string | undefined; } /** * @public */ export interface DescribeDeviceFleetRequest { /** *The name of the fleet.
* @public */ DeviceFleetName: string | undefined; } /** * @public */ export interface DescribeDeviceFleetResponse { /** *The name of the fleet.
* @public */ DeviceFleetName: string | undefined; /** *The The Amazon Resource Name (ARN) of the fleet.
* @public */ DeviceFleetArn: string | undefined; /** *The output configuration for storing sampled data.
* @public */ OutputConfig: EdgeOutputConfig | undefined; /** *A description of the fleet.
* @public */ Description?: string | undefined; /** *Timestamp of when the device fleet was created.
* @public */ CreationTime: Date | undefined; /** *Timestamp of when the device fleet was last updated.
* @public */ LastModifiedTime: Date | undefined; /** *The Amazon Resource Name (ARN) that has access to Amazon Web Services Internet of Things (IoT).
* @public */ RoleArn?: string | undefined; /** *The Amazon Resource Name (ARN) alias created in Amazon Web Services Internet of Things (IoT).
* @public */ IotRoleAlias?: string | undefined; } /** * @public */ export interface DescribeDomainRequest { /** *The domain ID.
* @public */ DomainId: string | undefined; } /** * @public * @enum */ export declare const DomainStatus: { readonly Delete_Failed: "Delete_Failed"; readonly Deleting: "Deleting"; readonly Failed: "Failed"; readonly InService: "InService"; readonly Pending: "Pending"; readonly Update_Failed: "Update_Failed"; readonly Updating: "Updating"; }; /** * @public */ export type DomainStatus = (typeof DomainStatus)[keyof typeof DomainStatus]; /** * @public */ export interface DescribeDomainResponse { /** *The domain's Amazon Resource Name (ARN).
* @public */ DomainArn?: string | undefined; /** *The domain ID.
* @public */ DomainId?: string | undefined; /** *The domain name.
* @public */ DomainName?: string | undefined; /** *The ID of the Amazon Elastic File System managed by this Domain.
* @public */ HomeEfsFileSystemId?: string | undefined; /** *The IAM Identity Center managed application instance ID.
* @public */ SingleSignOnManagedApplicationInstanceId?: string | undefined; /** *The ARN of the application managed by SageMaker AI in IAM Identity Center. This value is only returned for domains created after October 1, 2023.
* @public */ SingleSignOnApplicationArn?: string | undefined; /** *The status.
* @public */ Status?: DomainStatus | undefined; /** *The creation time.
* @public */ CreationTime?: Date | undefined; /** *The last modified time.
* @public */ LastModifiedTime?: Date | undefined; /** *The failure reason.
* @public */ FailureReason?: string | undefined; /** *The ID of the security group that authorizes traffic between the RSessionGateway apps and the RStudioServerPro app.
The domain's authentication mode.
* @public */ AuthMode?: AuthMode | undefined; /** *Settings which are applied to UserProfiles in this domain if settings are not explicitly specified in a given UserProfile.
* @public */ DefaultUserSettings?: UserSettings | undefined; /** *A collection of Domain settings.
Specifies the VPC used for non-EFS traffic. The default value is PublicInternetOnly.
PublicInternetOnly - Non-EFS traffic is through a VPC managed by Amazon SageMaker AI, which allows direct internet access
VpcOnly - All traffic is through the specified VPC and subnets
Use KmsKeyId.
The VPC subnets that the domain uses for communication.
* @public */ SubnetIds?: string[] | undefined; /** *The domain's URL.
* @public */ Url?: string | undefined; /** *The ID of the Amazon Virtual Private Cloud (VPC) that the domain uses for communication.
* @public */ VpcId?: string | undefined; /** *The Amazon Web Services KMS customer managed key used to encrypt the EFS volume attached to the domain.
* @public */ KmsKeyId?: string | undefined; /** *The entity that creates and manages the required security groups for inter-app communication in VPCOnly mode. Required when CreateDomain.AppNetworkAccessType is VPCOnly and DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn is provided.
Indicates whether custom tag propagation is supported for the domain.
* @public */ TagPropagation?: TagPropagation | undefined; /** *The default settings for shared spaces that users create in the domain.
* @public */ DefaultSpaceSettings?: DefaultSpaceSettings | undefined; } /** * @public */ export interface DescribeEdgeDeploymentPlanRequest { /** *The name of the deployment plan to describe.
* @public */ EdgeDeploymentPlanName: string | undefined; /** *If the edge deployment plan has enough stages to require tokening, then this is the response from the last list of stages returned.
* @public */ NextToken?: string | undefined; /** *The maximum number of results to select (50 by default).
* @public */ MaxResults?: number | undefined; } /** * @public */ export interface DescribeEdgeDeploymentPlanResponse { /** *The ARN of edge deployment plan.
* @public */ EdgeDeploymentPlanArn: string | undefined; /** *The name of the edge deployment plan.
* @public */ EdgeDeploymentPlanName: string | undefined; /** *List of models associated with the edge deployment plan.
* @public */ ModelConfigs: EdgeDeploymentModelConfig[] | undefined; /** *The device fleet used for this edge deployment plan.
* @public */ DeviceFleetName: string | undefined; /** *The number of edge devices with the successful deployment.
* @public */ EdgeDeploymentSuccess?: number | undefined; /** *The number of edge devices yet to pick up deployment, or in progress.
* @public */ EdgeDeploymentPending?: number | undefined; /** *The number of edge devices that failed the deployment.
* @public */ EdgeDeploymentFailed?: number | undefined; /** *List of stages in the edge deployment plan.
* @public */ Stages: DeploymentStageStatusSummary[] | undefined; /** *Token to use when calling the next set of stages in the edge deployment plan.
* @public */ NextToken?: string | undefined; /** *The time when the edge deployment plan was created.
* @public */ CreationTime?: Date | undefined; /** *The time when the edge deployment plan was last updated.
* @public */ LastModifiedTime?: Date | undefined; } /** * @public */ export interface DescribeEdgePackagingJobRequest { /** *The name of the edge packaging job.
* @public */ EdgePackagingJobName: string | undefined; } /** * @public * @enum */ export declare const EdgePackagingJobStatus: { readonly Completed: "COMPLETED"; readonly Failed: "FAILED"; readonly InProgress: "INPROGRESS"; readonly Starting: "STARTING"; readonly Stopped: "STOPPED"; readonly Stopping: "STOPPING"; }; /** * @public */ export type EdgePackagingJobStatus = (typeof EdgePackagingJobStatus)[keyof typeof EdgePackagingJobStatus]; /** * @public * @enum */ export declare const EdgePresetDeploymentStatus: { readonly Completed: "COMPLETED"; readonly Failed: "FAILED"; }; /** * @public */ export type EdgePresetDeploymentStatus = (typeof EdgePresetDeploymentStatus)[keyof typeof EdgePresetDeploymentStatus]; /** *The output of a SageMaker Edge Manager deployable resource.
* @public */ export interface EdgePresetDeploymentOutput { /** *The deployment type created by SageMaker Edge Manager. Currently only supports Amazon Web Services IoT Greengrass Version 2 components.
* @public */ Type: EdgePresetDeploymentType | undefined; /** *The Amazon Resource Name (ARN) of the generated deployable resource.
* @public */ Artifact?: string | undefined; /** *The status of the deployable resource.
* @public */ Status?: EdgePresetDeploymentStatus | undefined; /** *Returns a message describing the status of the deployed resource.
* @public */ StatusMessage?: string | undefined; } /** * @public */ export interface DescribeEdgePackagingJobResponse { /** *The Amazon Resource Name (ARN) of the edge packaging job.
* @public */ EdgePackagingJobArn: string | undefined; /** *The name of the edge packaging job.
* @public */ EdgePackagingJobName: string | undefined; /** *The name of the SageMaker Neo compilation job that is used to locate model artifacts that are being packaged.
* @public */ CompilationJobName?: string | undefined; /** *The name of the model.
* @public */ ModelName?: string | undefined; /** *The version of the model.
* @public */ ModelVersion?: string | undefined; /** *The Amazon Resource Name (ARN) of an IAM role that enables Amazon SageMaker to download and upload the model, and to contact Neo.
* @public */ RoleArn?: string | undefined; /** *The output configuration for the edge packaging job.
* @public */ OutputConfig?: EdgeOutputConfig | undefined; /** *The Amazon Web Services KMS key to use when encrypting the EBS volume the job run on.
* @public */ ResourceKey?: string | undefined; /** *The current status of the packaging job.
* @public */ EdgePackagingJobStatus: EdgePackagingJobStatus | undefined; /** *Returns a message describing the job status and error messages.
* @public */ EdgePackagingJobStatusMessage?: string | undefined; /** *The timestamp of when the packaging job was created.
* @public */ CreationTime?: Date | undefined; /** *The timestamp of when the job was last updated.
* @public */ LastModifiedTime?: Date | undefined; /** *The Amazon Simple Storage (S3) URI where model artifacts ares stored.
* @public */ ModelArtifact?: string | undefined; /** *The signature document of files in the model artifact.
* @public */ ModelSignature?: string | undefined; /** *The output of a SageMaker Edge Manager deployable resource.
* @public */ PresetDeploymentOutput?: EdgePresetDeploymentOutput | undefined; } /** * @public */ export interface DescribeEndpointInput { /** *The name of the endpoint.
* @public */ EndpointName: string | undefined; } /** * @public * @enum */ export declare const EndpointStatus: { readonly CREATING: "Creating"; readonly DELETING: "Deleting"; readonly FAILED: "Failed"; readonly IN_SERVICE: "InService"; readonly OUT_OF_SERVICE: "OutOfService"; readonly ROLLING_BACK: "RollingBack"; readonly SYSTEM_UPDATING: "SystemUpdating"; readonly UPDATE_ROLLBACK_FAILED: "UpdateRollbackFailed"; readonly UPDATING: "Updating"; }; /** * @public */ export type EndpointStatus = (typeof EndpointStatus)[keyof typeof EndpointStatus]; /** * @public * @enum */ export declare const VariantStatus: { readonly ACTIVATING_TRAFFIC: "ActivatingTraffic"; readonly BAKING: "Baking"; readonly CREATING: "Creating"; readonly DELETING: "Deleting"; readonly UPDATING: "Updating"; }; /** * @public */ export type VariantStatus = (typeof VariantStatus)[keyof typeof VariantStatus]; /** *Describes the status of the production variant.
* @public */ export interface ProductionVariantStatus { /** *The endpoint variant status which describes the current deployment stage status or operational status.
Creating: Creating inference resources for the production variant.
Deleting: Terminating inference resources for the production variant.
Updating: Updating capacity for the production variant.
ActivatingTraffic: Turning on traffic for the production variant.
Baking: Waiting period to monitor the CloudWatch alarms in the automatic rollback configuration.
A message that describes the status of the production variant.
* @public */ StatusMessage?: string | undefined; /** *The start time of the current status change.
* @public */ StartTime?: Date | undefined; } /** *The production variant summary for a deployment when an endpoint is creating or updating with the CreateEndpoint or UpdateEndpoint operations. Describes the VariantStatus , weight and capacity for a production variant associated with an endpoint.
The name of the variant.
* @public */ VariantName: string | undefined; /** *An array of DeployedImage objects that specify the Amazon EC2 Container Registry paths of the inference images deployed on instances of this ProductionVariant.
The weight associated with the variant.
* @public */ CurrentWeight?: number | undefined; /** *The requested weight for the variant in this deployment, as specified in the endpoint configuration for the endpoint. The value is taken from the request to the CreateEndpointConfig operation.
* @public */ DesiredWeight?: number | undefined; /** *The number of instances associated with the variant.
* @public */ CurrentInstanceCount?: number | undefined; /** *The number of instances requested in this deployment, as specified in the endpoint configuration for the endpoint. The value is taken from the request to the CreateEndpointConfig operation.
* @public */ DesiredInstanceCount?: number | undefined; /** *The type of instances associated with the variant.
* @public */ InstanceType?: ProductionVariantInstanceType | undefined; /** *This parameter is no longer supported. Elastic Inference (EI) is no longer available.
This parameter was used to specify the size of the EI instance to use for the production variant.
* @public */ AcceleratorType?: ProductionVariantAcceleratorType | undefined; /** *The endpoint variant status which describes the current deployment stage status or operational status.
* @public */ VariantStatus?: ProductionVariantStatus[] | undefined; /** *The serverless configuration for the endpoint.
* @public */ CurrentServerlessConfig?: ProductionVariantServerlessConfig | undefined; /** *The serverless configuration requested for this deployment, as specified in the endpoint configuration for the endpoint.
* @public */ DesiredServerlessConfig?: ProductionVariantServerlessConfig | undefined; /** *Settings that control the range in the number of instances that the endpoint provisions as it scales up or down to accommodate traffic.
* @public */ ManagedInstanceScaling?: ProductionVariantManagedInstanceScaling | undefined; /** *Settings that control how the endpoint routes incoming traffic to the instances that the endpoint hosts.
* @public */ RoutingConfig?: ProductionVariantRoutingConfig | undefined; } /** *The summary of an in-progress deployment when an endpoint is creating or updating with a new endpoint configuration.
* @public */ export interface PendingDeploymentSummary { /** *The name of the endpoint configuration used in the deployment.
* @public */ EndpointConfigName: string | undefined; /** *An array of PendingProductionVariantSummary objects, one for each model hosted behind this endpoint for the in-progress deployment.
* @public */ ProductionVariants?: PendingProductionVariantSummary[] | undefined; /** *The start time of the deployment.
* @public */ StartTime?: Date | undefined; /** *An array of PendingProductionVariantSummary objects, one for each model hosted behind this endpoint in shadow mode with production traffic replicated from the model specified on ProductionVariants for the in-progress deployment.
The EC2 capacity reservations that are shared to an ML capacity reservation.
* @public */ export interface Ec2CapacityReservation { /** *The unique identifier for an EC2 capacity reservation that's part of the ML capacity reservation.
* @public */ Ec2CapacityReservationId?: string | undefined; /** *The number of instances that you allocated to the EC2 capacity reservation.
* @public */ TotalInstanceCount?: number | undefined; /** *The number of instances that are currently available in the EC2 capacity reservation.
* @public */ AvailableInstanceCount?: number | undefined; /** *The number of instances from the EC2 capacity reservation that are being used by the endpoint.
* @public */ UsedByCurrentEndpoint?: number | undefined; } /** *Details about an ML capacity reservation.
* @public */ export interface ProductionVariantCapacityReservationSummary { /** *The Amazon Resource Name (ARN) that uniquely identifies the ML capacity reservation that SageMaker AI applies when it deploys the endpoint.
* @public */ MlReservationArn?: string | undefined; /** *The option that you chose for the capacity reservation. SageMaker AI supports the following options:
SageMaker AI launches instances only into an ML capacity reservation. If no capacity is available, the instances fail to launch.
The number of instances that you allocated to the ML capacity reservation.
* @public */ TotalInstanceCount?: number | undefined; /** *The number of instances that are currently available in the ML capacity reservation.
* @public */ AvailableInstanceCount?: number | undefined; /** *The number of instances from the ML capacity reservation that are being used by the endpoint.
* @public */ UsedByCurrentEndpoint?: number | undefined; /** *The EC2 capacity reservations that are shared to this ML capacity reservation, if any.
* @public */ Ec2CapacityReservations?: Ec2CapacityReservation[] | undefined; } /** *Describes weight and capacities for a production variant associated with an endpoint. If you sent a request to the UpdateEndpointWeightsAndCapacities API and the endpoint status is Updating, you get different desired and current values.
The name of the variant.
* @public */ VariantName: string | undefined; /** *An array of DeployedImage objects that specify the Amazon EC2 Container Registry paths of the inference images deployed on instances of this ProductionVariant.
The weight associated with the variant.
* @public */ CurrentWeight?: number | undefined; /** *The requested weight, as specified in the UpdateEndpointWeightsAndCapacities request.
The number of instances associated with the variant.
* @public */ CurrentInstanceCount?: number | undefined; /** *The number of instances requested in the UpdateEndpointWeightsAndCapacities request.
The endpoint variant status which describes the current deployment stage status or operational status.
* @public */ VariantStatus?: ProductionVariantStatus[] | undefined; /** *The serverless configuration for the endpoint.
* @public */ CurrentServerlessConfig?: ProductionVariantServerlessConfig | undefined; /** *The serverless configuration requested for the endpoint update.
* @public */ DesiredServerlessConfig?: ProductionVariantServerlessConfig | undefined; /** *Settings that control the range in the number of instances that the endpoint provisions as it scales up or down to accommodate traffic.
* @public */ ManagedInstanceScaling?: ProductionVariantManagedInstanceScaling | undefined; /** *Settings that control how the endpoint routes incoming traffic to the instances that the endpoint hosts.
* @public */ RoutingConfig?: ProductionVariantRoutingConfig | undefined; /** *Settings for the capacity reservation for the compute instances that SageMaker AI reserves for an endpoint.
* @public */ CapacityReservationConfig?: ProductionVariantCapacityReservationSummary | undefined; } /** * @public */ export interface DescribeEndpointOutput { /** *Name of the endpoint.
* @public */ EndpointName: string | undefined; /** *The Amazon Resource Name (ARN) of the endpoint.
* @public */ EndpointArn: string | undefined; /** *The name of the endpoint configuration associated with this endpoint.
* @public */ EndpointConfigName?: string | undefined; /** *An array of ProductionVariantSummary objects, one for each model hosted behind this endpoint.
* @public */ ProductionVariants?: ProductionVariantSummary[] | undefined; /** *The currently active data capture configuration used by your Endpoint.
* @public */ DataCaptureConfig?: DataCaptureConfigSummary | undefined; /** *The status of the endpoint.
OutOfService: Endpoint is not available to take incoming requests.
Creating: CreateEndpoint is executing.
Updating: UpdateEndpoint or UpdateEndpointWeightsAndCapacities is executing.
SystemUpdating: Endpoint is undergoing maintenance and cannot be updated or deleted or re-scaled until it has completed. This maintenance operation does not change any customer-specified values such as VPC config, KMS encryption, model, instance type, or instance count.
RollingBack: Endpoint fails to scale up or down or change its variant weight and is in the process of rolling back to its previous configuration. Once the rollback completes, endpoint returns to an InService status. This transitional status only applies to an endpoint that has autoscaling enabled and is undergoing variant weight or capacity changes as part of an UpdateEndpointWeightsAndCapacities call or when the UpdateEndpointWeightsAndCapacities operation is called explicitly.
InService: Endpoint is available to process incoming requests.
Deleting: DeleteEndpoint is executing.
Failed: Endpoint could not be created, updated, or re-scaled. Use the FailureReason value returned by DescribeEndpoint for information about the failure. DeleteEndpoint is the only operation that can be performed on a failed endpoint.
UpdateRollbackFailed: Both the rolling deployment and auto-rollback failed. Your endpoint is in service with a mix of the old and new endpoint configurations. For information about how to remedy this issue and restore the endpoint's status to InService, see Rolling Deployments.
If the status of the endpoint is Failed, the reason why it failed.
A timestamp that shows when the endpoint was created.
* @public */ CreationTime: Date | undefined; /** *A timestamp that shows when the endpoint was last modified.
* @public */ LastModifiedTime: Date | undefined; /** *The most recent deployment configuration for the endpoint.
* @public */ LastDeploymentConfig?: DeploymentConfig | undefined; /** *Returns the description of an endpoint configuration created using the CreateEndpointConfig API.
Returns the summary of an in-progress deployment. This field is only returned when the endpoint is creating or updating with a new endpoint configuration.
* @public */ PendingDeploymentSummary?: PendingDeploymentSummary | undefined; /** *The configuration parameters for an explainer.
* @public */ ExplainerConfig?: ExplainerConfig | undefined; /** *An array of ProductionVariantSummary objects, one for each model that you want to host at this endpoint in shadow mode with production traffic replicated from the model specified on ProductionVariants.
The name of the endpoint configuration.
* @public */ EndpointConfigName: string | undefined; } /** * @public */ export interface DescribeEndpointConfigOutput { /** *Name of the SageMaker endpoint configuration.
* @public */ EndpointConfigName: string | undefined; /** *The Amazon Resource Name (ARN) of the endpoint configuration.
* @public */ EndpointConfigArn: string | undefined; /** *An array of ProductionVariant objects, one for each model that you want to host at this endpoint.
Configuration to control how SageMaker AI captures inference data.
* @public */ DataCaptureConfig?: DataCaptureConfig | undefined; /** *Amazon Web Services KMS key ID Amazon SageMaker uses to encrypt data when storing it on the ML storage volume attached to the instance.
* @public */ KmsKeyId?: string | undefined; /** *A timestamp that shows when the endpoint configuration was created.
* @public */ CreationTime: Date | undefined; /** *Returns the description of an endpoint configuration created using the CreateEndpointConfig API.
The configuration parameters for an explainer.
* @public */ ExplainerConfig?: ExplainerConfig | undefined; /** *An array of ProductionVariant objects, one for each model that you want to host at this endpoint in shadow mode with production traffic replicated from the model specified on ProductionVariants.
The Amazon Resource Name (ARN) of the IAM role that you assigned to the endpoint configuration.
* @public */ ExecutionRoleArn?: string | undefined; /** *Specifies an Amazon Virtual Private Cloud (VPC) that your SageMaker jobs, hosted models, and compute resources have access to. You can control access to and from your resources by configuring a VPC. For more information, see Give SageMaker Access to Resources in your Amazon VPC.
* @public */ VpcConfig?: VpcConfig | undefined; /** *Indicates whether all model containers deployed to the endpoint are isolated. If they are, no inbound or outbound network calls can be made to or from the model containers.
* @public */ EnableNetworkIsolation?: boolean | undefined; } /** * @public */ export interface DescribeExperimentRequest { /** *The name of the experiment to describe.
* @public */ ExperimentName: string | undefined; } /** *The source of the experiment.
* @public */ export interface ExperimentSource { /** *The Amazon Resource Name (ARN) of the source.
* @public */ SourceArn: string | undefined; /** *The source type.
* @public */ SourceType?: string | undefined; } /** * @public */ export interface DescribeExperimentResponse { /** *The name of the experiment.
* @public */ ExperimentName?: string | undefined; /** *The Amazon Resource Name (ARN) of the experiment.
* @public */ ExperimentArn?: string | undefined; /** *The name of the experiment as displayed. If DisplayName isn't specified, ExperimentName is displayed.
The Amazon Resource Name (ARN) of the source and, optionally, the type.
* @public */ Source?: ExperimentSource | undefined; /** *The description of the experiment.
* @public */ Description?: string | undefined; /** *When the experiment was created.
* @public */ CreationTime?: Date | undefined; /** *Who created the experiment.
* @public */ CreatedBy?: UserContext | undefined; /** *When the experiment was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Who last modified the experiment.
* @public */ LastModifiedBy?: UserContext | undefined; } /** * @public */ export interface DescribeFeatureGroupRequest { /** *The name or Amazon Resource Name (ARN) of the FeatureGroup you want described.
A token to resume pagination of the list of Features (FeatureDefinitions). 2,500 Features are returned by default.
A value that indicates whether the update was successful.
* @public */ export interface LastUpdateStatus { /** *A value that indicates whether the update was made successful.
* @public */ Status: LastUpdateStatusValue | undefined; /** *If the update wasn't successful, indicates the reason why it failed.
* @public */ FailureReason?: string | undefined; } /** * @public * @enum */ export declare const OfflineStoreStatusValue: { readonly ACTIVE: "Active"; readonly BLOCKED: "Blocked"; readonly DISABLED: "Disabled"; }; /** * @public */ export type OfflineStoreStatusValue = (typeof OfflineStoreStatusValue)[keyof typeof OfflineStoreStatusValue]; /** *The status of OfflineStore.
An OfflineStore status.
The justification for why the OfflineStoreStatus is Blocked (if applicable).
* @public */ BlockedReason?: string | undefined; } /** *Active throughput configuration of the feature group. There are two modes: ON_DEMAND and PROVISIONED. With on-demand mode, you are charged for data reads and writes that your application performs on your feature group. You do not need to specify read and write throughput because Feature Store accommodates your workloads as they ramp up and down. You can switch a feature group to on-demand only once in a 24 hour period. With provisioned throughput mode, you specify the read and write capacity per second that you expect your application to require, and you are billed based on those limits. Exceeding provisioned throughput will result in your requests being throttled.
Note: PROVISIONED throughput mode is supported only for feature groups that are offline-only, or use the Standard tier online store.
The mode used for your feature group throughput: ON_DEMAND or PROVISIONED.
For provisioned feature groups with online store enabled, this indicates the read throughput you are billed for and can consume without throttling.
This field is not applicable for on-demand feature groups.
* @public */ ProvisionedReadCapacityUnits?: number | undefined; /** *For provisioned feature groups, this indicates the write throughput you are billed for and can consume without throttling.
This field is not applicable for on-demand feature groups.
* @public */ ProvisionedWriteCapacityUnits?: number | undefined; } /** * @public */ export interface DescribeFeatureGroupResponse { /** *The Amazon Resource Name (ARN) of the FeatureGroup.
he name of the FeatureGroup.
The name of the Feature used for RecordIdentifier, whose value uniquely identifies a record stored in the feature store.
The name of the feature that stores the EventTime of a Record in a FeatureGroup.
An EventTime is a point in time when a new event occurs that corresponds to the creation or update of a Record in a FeatureGroup. All Records in the FeatureGroup have a corresponding EventTime.
A list of the Features in the FeatureGroup. Each feature is defined by a FeatureName and FeatureType.
A timestamp indicating when SageMaker created the FeatureGroup.
A timestamp indicating when the feature group was last updated.
* @public */ LastModifiedTime?: Date | undefined; /** *The configuration for the OnlineStore.
The configuration of the offline store. It includes the following configurations:
Amazon S3 location of the offline store.
Configuration of the Glue data catalog.
Table format of the offline store.
Option to disable the automatic creation of a Glue table for the offline store.
Encryption configuration.
Active throughput configuration of the feature group. There are two modes: ON_DEMAND and PROVISIONED. With on-demand mode, you are charged for data reads and writes that your application performs on your feature group. You do not need to specify read and write throughput because Feature Store accommodates your workloads as they ramp up and down. You can switch a feature group to on-demand only once in a 24 hour period. With provisioned throughput mode, you specify the read and write capacity per second that you expect your application to require, and you are billed based on those limits. Exceeding provisioned throughput will result in your requests being throttled.
Note: PROVISIONED throughput mode is supported only for feature groups that are offline-only, or use the Standard tier online store.
The Amazon Resource Name (ARN) of the IAM execution role used to persist data into the OfflineStore if an OfflineStoreConfig is provided.
* @public */ RoleArn?: string | undefined; /** *The status of the feature group.
* @public */ FeatureGroupStatus?: FeatureGroupStatus | undefined; /** *The status of the OfflineStore. Notifies you if replicating data into the OfflineStore has failed. Returns either: Active or Blocked
A value indicating whether the update made to the feature group was successful.
* @public */ LastUpdateStatus?: LastUpdateStatus | undefined; /** *The reason that the FeatureGroup failed to be replicated in the OfflineStore. This is failure can occur because:
The FeatureGroup could not be created in the OfflineStore.
The FeatureGroup could not be deleted from the OfflineStore.
A free form description of the feature group.
* @public */ Description?: string | undefined; /** *A token to resume pagination of the list of Features (FeatureDefinitions).
The size of the OnlineStore in bytes.
The name or Amazon Resource Name (ARN) of the feature group containing the feature.
* @public */ FeatureGroupName: string | undefined; /** *The name of the feature.
* @public */ FeatureName: string | undefined; } /** *A key-value pair that you specify to describe the feature.
* @public */ export interface FeatureParameter { /** *A key that must contain a value to describe the feature.
* @public */ Key?: string | undefined; /** *The value that belongs to a key.
* @public */ Value?: string | undefined; } /** * @public */ export interface DescribeFeatureMetadataResponse { /** *The Amazon Resource Number (ARN) of the feature group that contains the feature.
* @public */ FeatureGroupArn: string | undefined; /** *The name of the feature group that you've specified.
* @public */ FeatureGroupName: string | undefined; /** *The name of the feature that you've specified.
* @public */ FeatureName: string | undefined; /** *The data type of the feature.
* @public */ FeatureType: FeatureType | undefined; /** *A timestamp indicating when the feature was created.
* @public */ CreationTime: Date | undefined; /** *A timestamp indicating when the metadata for the feature group was modified. For example, if you add a parameter describing the feature, the timestamp changes to reflect the last time you
* @public */ LastModifiedTime: Date | undefined; /** *The description you added to describe the feature.
* @public */ Description?: string | undefined; /** *The key-value pairs that you added to describe the feature.
* @public */ Parameters?: FeatureParameter[] | undefined; } /** * @public */ export interface DescribeFlowDefinitionRequest { /** *The name of the flow definition.
* @public */ FlowDefinitionName: string | undefined; } /** * @public * @enum */ export declare const FlowDefinitionStatus: { readonly ACTIVE: "Active"; readonly DELETING: "Deleting"; readonly FAILED: "Failed"; readonly INITIALIZING: "Initializing"; }; /** * @public */ export type FlowDefinitionStatus = (typeof FlowDefinitionStatus)[keyof typeof FlowDefinitionStatus]; /** * @public */ export interface DescribeFlowDefinitionResponse { /** *The Amazon Resource Name (ARN) of the flow defintion.
* @public */ FlowDefinitionArn: string | undefined; /** *The Amazon Resource Name (ARN) of the flow definition.
* @public */ FlowDefinitionName: string | undefined; /** *The status of the flow definition. Valid values are listed below.
* @public */ FlowDefinitionStatus: FlowDefinitionStatus | undefined; /** *The timestamp when the flow definition was created.
* @public */ CreationTime: Date | undefined; /** *Container for configuring the source of human task requests. Used to specify if Amazon Rekognition or Amazon Textract is used as an integration source.
* @public */ HumanLoopRequestSource?: HumanLoopRequestSource | undefined; /** *An object containing information about what triggers a human review workflow.
* @public */ HumanLoopActivationConfig?: HumanLoopActivationConfig | undefined; /** *An object containing information about who works on the task, the workforce task price, and other task details.
* @public */ HumanLoopConfig?: HumanLoopConfig | undefined; /** *An object containing information about the output file.
* @public */ OutputConfig: FlowDefinitionOutputConfig | undefined; /** *The Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) execution role for the flow definition.
* @public */ RoleArn: string | undefined; /** *The reason your flow definition failed.
* @public */ FailureReason?: string | undefined; } /** * @public */ export interface DescribeHubRequest { /** *The name of the hub to describe.
* @public */ HubName: string | undefined; } /** * @public * @enum */ export declare const HubStatus: { readonly CREATE_FAILED: "CreateFailed"; readonly CREATING: "Creating"; readonly DELETE_FAILED: "DeleteFailed"; readonly DELETING: "Deleting"; readonly IN_SERVICE: "InService"; readonly UPDATE_FAILED: "UpdateFailed"; readonly UPDATING: "Updating"; }; /** * @public */ export type HubStatus = (typeof HubStatus)[keyof typeof HubStatus]; /** * @public */ export interface DescribeHubResponse { /** *The name of the hub.
* @public */ HubName: string | undefined; /** *The Amazon Resource Name (ARN) of the hub.
* @public */ HubArn: string | undefined; /** *The display name of the hub.
* @public */ HubDisplayName?: string | undefined; /** *A description of the hub.
* @public */ HubDescription?: string | undefined; /** *The searchable keywords for the hub.
* @public */ HubSearchKeywords?: string[] | undefined; /** *The Amazon S3 storage configuration for the hub.
* @public */ S3StorageConfig?: HubS3StorageConfig | undefined; /** *The status of the hub.
* @public */ HubStatus: HubStatus | undefined; /** *The failure reason if importing hub content failed.
* @public */ FailureReason?: string | undefined; /** *The date and time that the hub was created.
* @public */ CreationTime: Date | undefined; /** *The date and time that the hub was last modified.
* @public */ LastModifiedTime: Date | undefined; } /** * @public */ export interface DescribeHubContentRequest { /** *The name of the hub that contains the content to describe.
* @public */ HubName: string | undefined; /** *The type of content in the hub.
* @public */ HubContentType: HubContentType | undefined; /** *The name of the content to describe.
* @public */ HubContentName: string | undefined; /** *The version of the content to describe.
* @public */ HubContentVersion?: string | undefined; } /** *Any dependencies related to hub content, such as scripts, model artifacts, datasets, or notebooks.
* @public */ export interface HubContentDependency { /** *The hub content dependency origin path.
* @public */ DependencyOriginPath?: string | undefined; /** *The hub content dependency copy path.
* @public */ DependencyCopyPath?: string | undefined; } /** * @public * @enum */ export declare const HubContentStatus: { readonly AVAILABLE: "Available"; readonly DELETE_FAILED: "DeleteFailed"; readonly DELETING: "Deleting"; readonly IMPORTING: "Importing"; readonly IMPORT_FAILED: "ImportFailed"; }; /** * @public */ export type HubContentStatus = (typeof HubContentStatus)[keyof typeof HubContentStatus]; /** * @public * @enum */ export declare const HubContentSupportStatus: { readonly DEPRECATED: "Deprecated"; readonly RESTRICTED: "Restricted"; readonly SUPPORTED: "Supported"; }; /** * @public */ export type HubContentSupportStatus = (typeof HubContentSupportStatus)[keyof typeof HubContentSupportStatus]; /** * @public */ export interface DescribeHubContentResponse { /** *The name of the hub content.
* @public */ HubContentName: string | undefined; /** *The Amazon Resource Name (ARN) of the hub content.
* @public */ HubContentArn: string | undefined; /** *The version of the hub content.
* @public */ HubContentVersion: string | undefined; /** *The type of hub content.
* @public */ HubContentType: HubContentType | undefined; /** *The document schema version for the hub content.
* @public */ DocumentSchemaVersion: string | undefined; /** *The name of the hub that contains the content.
* @public */ HubName: string | undefined; /** *The Amazon Resource Name (ARN) of the hub that contains the content.
* @public */ HubArn: string | undefined; /** *The display name of the hub content.
* @public */ HubContentDisplayName?: string | undefined; /** *A description of the hub content.
* @public */ HubContentDescription?: string | undefined; /** *A string that provides a description of the hub content. This string can include links, tables, and standard markdown formating.
* @public */ HubContentMarkdown?: string | undefined; /** *The hub content document that describes information about the hub content such as type, associated containers, scripts, and more.
* @public */ HubContentDocument: string | undefined; /** *The ARN of the public hub content.
* @public */ SageMakerPublicHubContentArn?: string | undefined; /** *The minimum version of the hub content.
* @public */ ReferenceMinVersion?: string | undefined; /** *The support status of the hub content.
* @public */ SupportStatus?: HubContentSupportStatus | undefined; /** *The searchable keywords for the hub content.
* @public */ HubContentSearchKeywords?: string[] | undefined; /** *The location of any dependencies that the hub content has, such as scripts, model artifacts, datasets, or notebooks.
* @public */ HubContentDependencies?: HubContentDependency[] | undefined; /** *The status of the hub content.
* @public */ HubContentStatus: HubContentStatus | undefined; /** *The failure reason if importing hub content failed.
* @public */ FailureReason?: string | undefined; /** *The date and time that hub content was created.
* @public */ CreationTime: Date | undefined; /** *The last modified time of the hub content.
* @public */ LastModifiedTime?: Date | undefined; } /** * @public */ export interface DescribeHumanTaskUiRequest { /** *The name of the human task user interface (worker task template) you want information about.
* @public */ HumanTaskUiName: string | undefined; } /** * @public * @enum */ export declare const HumanTaskUiStatus: { readonly ACTIVE: "Active"; readonly DELETING: "Deleting"; }; /** * @public */ export type HumanTaskUiStatus = (typeof HumanTaskUiStatus)[keyof typeof HumanTaskUiStatus]; /** *Container for user interface template information.
* @public */ export interface UiTemplateInfo { /** *The URL for the user interface template.
* @public */ Url?: string | undefined; /** *The SHA-256 digest of the contents of the template.
* @public */ ContentSha256?: string | undefined; } /** * @public */ export interface DescribeHumanTaskUiResponse { /** *The Amazon Resource Name (ARN) of the human task user interface (worker task template).
* @public */ HumanTaskUiArn: string | undefined; /** *The name of the human task user interface (worker task template).
* @public */ HumanTaskUiName: string | undefined; /** *The status of the human task user interface (worker task template). Valid values are listed below.
* @public */ HumanTaskUiStatus?: HumanTaskUiStatus | undefined; /** *The timestamp when the human task user interface was created.
* @public */ CreationTime: Date | undefined; /** *Container for user interface template information.
* @public */ UiTemplate: UiTemplateInfo | undefined; } /** * @public */ export interface DescribeHyperParameterTuningJobRequest { /** *The name of the tuning job.
* @public */ HyperParameterTuningJobName: string | undefined; } /** *Shows the latest objective metric emitted by a training job that was launched by a hyperparameter tuning job. You define the objective metric in the HyperParameterTuningJobObjective parameter of HyperParameterTuningJobConfig.
Select if you want to minimize or maximize the objective metric during hyperparameter tuning.
* @public */ Type?: HyperParameterTuningJobObjectiveType | undefined; /** *The name of the objective metric. For SageMaker built-in algorithms, metrics are defined per algorithm. See the metrics for XGBoost as an example. You can also use a custom algorithm for training and define your own metrics. For more information, see Define metrics and environment variables.
* @public */ MetricName: string | undefined; /** *The value of the objective metric.
* @public */ Value: number | undefined; } /** * @public * @enum */ export declare const TrainingJobStatus: { readonly COMPLETED: "Completed"; readonly FAILED: "Failed"; readonly IN_PROGRESS: "InProgress"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; }; /** * @public */ export type TrainingJobStatus = (typeof TrainingJobStatus)[keyof typeof TrainingJobStatus]; /** *The container for the summary information about a training job.
* @public */ export interface HyperParameterTrainingJobSummary { /** *The training job definition name.
* @public */ TrainingJobDefinitionName?: string | undefined; /** *The name of the training job.
* @public */ TrainingJobName: string | undefined; /** *The Amazon Resource Name (ARN) of the training job.
* @public */ TrainingJobArn: string | undefined; /** *The HyperParameter tuning job that launched the training job.
* @public */ TuningJobName?: string | undefined; /** *The date and time that the training job was created.
* @public */ CreationTime: Date | undefined; /** *The date and time that the training job started.
* @public */ TrainingStartTime?: Date | undefined; /** *Specifies the time when the training job ends on training instances. You are billed for the time interval between the value of TrainingStartTime and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when SageMaker detects a job failure.
The status of the training job.
* @public */ TrainingJobStatus: TrainingJobStatus | undefined; /** *A list of the hyperparameters for which you specified ranges to search.
* @public */ TunedHyperParameters: RecordThe reason that the training job failed.
* @public */ FailureReason?: string | undefined; /** *The FinalHyperParameterTuningJobObjectiveMetric object that specifies the value of the objective metric of the tuning job that launched this training job.
* @public */ FinalHyperParameterTuningJobObjectiveMetric?: FinalHyperParameterTuningJobObjectiveMetric | undefined; /** *The status of the objective metric for the training job:
Succeeded: The final objective metric for the training job was evaluated by the hyperparameter tuning job and used in the hyperparameter tuning process.
Pending: The training job is in progress and evaluation of its final objective metric is pending.
Failed: The final objective metric for the training job was not evaluated, and was not used in the hyperparameter tuning process. This typically occurs when the training job failed or did not emit an objective metric.
The total resources consumed by your hyperparameter tuning job.
* @public */ export interface HyperParameterTuningJobConsumedResources { /** *The wall clock runtime in seconds used by your hyperparameter tuning job.
* @public */ RuntimeInSeconds?: number | undefined; } /** * @public * @enum */ export declare const HyperParameterTuningJobStatus: { readonly COMPLETED: "Completed"; readonly DELETE_FAILED: "DeleteFailed"; readonly DELETING: "Deleting"; readonly FAILED: "Failed"; readonly IN_PROGRESS: "InProgress"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; }; /** * @public */ export type HyperParameterTuningJobStatus = (typeof HyperParameterTuningJobStatus)[keyof typeof HyperParameterTuningJobStatus]; /** *Specifies the number of training jobs that this hyperparameter tuning job launched, categorized by the status of their objective metric. The objective metric status shows whether the final objective metric for the training job has been evaluated by the tuning job and used in the hyperparameter tuning process.
* @public */ export interface ObjectiveStatusCounters { /** *The number of training jobs whose final objective metric was evaluated by the hyperparameter tuning job and used in the hyperparameter tuning process.
* @public */ Succeeded?: number | undefined; /** *The number of training jobs that are in progress and pending evaluation of their final objective metric.
* @public */ Pending?: number | undefined; /** *The number of training jobs whose final objective metric was not evaluated and used in the hyperparameter tuning process. This typically occurs when the training job failed or did not emit an objective metric.
* @public */ Failed?: number | undefined; } /** *The numbers of training jobs launched by a hyperparameter tuning job, categorized by status.
* @public */ export interface TrainingJobStatusCounters { /** *The number of completed training jobs launched by the hyperparameter tuning job.
* @public */ Completed?: number | undefined; /** *The number of in-progress training jobs launched by a hyperparameter tuning job.
* @public */ InProgress?: number | undefined; /** *The number of training jobs that failed, but can be retried. A failed training job can be retried only if it failed because an internal service error occurred.
* @public */ RetryableError?: number | undefined; /** *The number of training jobs that failed and can't be retried. A failed training job can't be retried if it failed because a client error occurred.
* @public */ NonRetryableError?: number | undefined; /** *The number of training jobs launched by a hyperparameter tuning job that were manually stopped.
* @public */ Stopped?: number | undefined; } /** *A structure that contains runtime information about both current and completed hyperparameter tuning jobs.
* @public */ export interface HyperParameterTuningJobCompletionDetails { /** *The number of training jobs launched by a tuning job that are not improving (1% or less) as measured by model performance evaluated against an objective function.
* @public */ NumberOfTrainingJobsObjectiveNotImproving?: number | undefined; /** *The time in timestamp format that AMT detected model convergence, as defined by a lack of significant improvement over time based on criteria developed over a wide range of diverse benchmarking tests.
* @public */ ConvergenceDetectedTime?: Date | undefined; } /** * @public */ export interface DescribeHyperParameterTuningJobResponse { /** *The name of the hyperparameter tuning job.
* @public */ HyperParameterTuningJobName: string | undefined; /** *The Amazon Resource Name (ARN) of the tuning job.
* @public */ HyperParameterTuningJobArn: string | undefined; /** *The HyperParameterTuningJobConfig object that specifies the configuration of the tuning job.
* @public */ HyperParameterTuningJobConfig: HyperParameterTuningJobConfig | undefined; /** *The HyperParameterTrainingJobDefinition object that specifies the definition of the training jobs that this tuning job launches.
* @public */ TrainingJobDefinition?: HyperParameterTrainingJobDefinition | undefined; /** *A list of the HyperParameterTrainingJobDefinition objects launched for this tuning job.
* @public */ TrainingJobDefinitions?: HyperParameterTrainingJobDefinition[] | undefined; /** *The status of the tuning job.
* @public */ HyperParameterTuningJobStatus: HyperParameterTuningJobStatus | undefined; /** *The date and time that the tuning job started.
* @public */ CreationTime: Date | undefined; /** *The date and time that the tuning job ended.
* @public */ HyperParameterTuningEndTime?: Date | undefined; /** *The date and time that the status of the tuning job was modified.
* @public */ LastModifiedTime?: Date | undefined; /** *The TrainingJobStatusCounters object that specifies the number of training jobs, categorized by status, that this tuning job launched.
* @public */ TrainingJobStatusCounters: TrainingJobStatusCounters | undefined; /** *The ObjectiveStatusCounters object that specifies the number of training jobs, categorized by the status of their final objective metric, that this tuning job launched.
* @public */ ObjectiveStatusCounters: ObjectiveStatusCounters | undefined; /** *A TrainingJobSummary object that describes the training job that completed with the best current HyperParameterTuningJobObjective.
* @public */ BestTrainingJob?: HyperParameterTrainingJobSummary | undefined; /** *If the hyperparameter tuning job is an warm start tuning job with a WarmStartType of IDENTICAL_DATA_AND_ALGORITHM, this is the TrainingJobSummary for the training job with the best objective metric value of all training jobs launched by this tuning job and all parent jobs specified for the warm start tuning job.
The configuration for starting the hyperparameter parameter tuning job using one or more previous tuning jobs as a starting point. The results of previous tuning jobs are used to inform which combinations of hyperparameters to search over in the new tuning job.
* @public */ WarmStartConfig?: HyperParameterTuningJobWarmStartConfig | undefined; /** *A flag to indicate if autotune is enabled for the hyperparameter tuning job.
* @public */ Autotune?: Autotune | undefined; /** *If the tuning job failed, the reason it failed.
* @public */ FailureReason?: string | undefined; /** *Tuning job completion information returned as the response from a hyperparameter tuning job. This information tells if your tuning job has or has not converged. It also includes the number of training jobs that have not improved model performance as evaluated against the objective function.
* @public */ TuningJobCompletionDetails?: HyperParameterTuningJobCompletionDetails | undefined; /** *The total resources consumed by your hyperparameter tuning job.
* @public */ ConsumedResources?: HyperParameterTuningJobConsumedResources | undefined; } /** * @public */ export interface DescribeImageRequest { /** *The name of the image to describe.
* @public */ ImageName: string | undefined; } /** * @public * @enum */ export declare const ImageStatus: { readonly CREATED: "CREATED"; readonly CREATE_FAILED: "CREATE_FAILED"; readonly CREATING: "CREATING"; readonly DELETE_FAILED: "DELETE_FAILED"; readonly DELETING: "DELETING"; readonly UPDATE_FAILED: "UPDATE_FAILED"; readonly UPDATING: "UPDATING"; }; /** * @public */ export type ImageStatus = (typeof ImageStatus)[keyof typeof ImageStatus]; /** * @public */ export interface DescribeImageResponse { /** *When the image was created.
* @public */ CreationTime?: Date | undefined; /** *The description of the image.
* @public */ Description?: string | undefined; /** *The name of the image as displayed.
* @public */ DisplayName?: string | undefined; /** *When a create, update, or delete operation fails, the reason for the failure.
* @public */ FailureReason?: string | undefined; /** *The ARN of the image.
* @public */ ImageArn?: string | undefined; /** *The name of the image.
* @public */ ImageName?: string | undefined; /** *The status of the image.
* @public */ ImageStatus?: ImageStatus | undefined; /** *When the image was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *The ARN of the IAM role that enables Amazon SageMaker AI to perform tasks on your behalf.
* @public */ RoleArn?: string | undefined; } /** * @public */ export interface DescribeImageVersionRequest { /** *The name of the image.
* @public */ ImageName: string | undefined; /** *The version of the image. If not specified, the latest version is described.
* @public */ Version?: number | undefined; /** *The alias of the image version.
* @public */ Alias?: string | undefined; } /** * @public * @enum */ export declare const ImageVersionStatus: { readonly CREATED: "CREATED"; readonly CREATE_FAILED: "CREATE_FAILED"; readonly CREATING: "CREATING"; readonly DELETE_FAILED: "DELETE_FAILED"; readonly DELETING: "DELETING"; }; /** * @public */ export type ImageVersionStatus = (typeof ImageVersionStatus)[keyof typeof ImageVersionStatus]; /** * @public */ export interface DescribeImageVersionResponse { /** *The registry path of the container image on which this image version is based.
* @public */ BaseImage?: string | undefined; /** *The registry path of the container image that contains this image version.
* @public */ ContainerImage?: string | undefined; /** *When the version was created.
* @public */ CreationTime?: Date | undefined; /** *When a create or delete operation fails, the reason for the failure.
* @public */ FailureReason?: string | undefined; /** *The ARN of the image the version is based on.
* @public */ ImageArn?: string | undefined; /** *The ARN of the version.
* @public */ ImageVersionArn?: string | undefined; /** *The status of the version.
* @public */ ImageVersionStatus?: ImageVersionStatus | undefined; /** *When the version was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *The version number.
* @public */ Version?: number | undefined; /** *The stability of the image version specified by the maintainer.
NOT_PROVIDED: The maintainers did not provide a status for image version stability.
STABLE: The image version is stable.
TO_BE_ARCHIVED: The image version is set to be archived. Custom image versions that are set to be archived are automatically archived after three months.
ARCHIVED: The image version is archived. Archived image versions are not searchable and are no longer actively supported.
Indicates SageMaker AI job type compatibility.
TRAINING: The image version is compatible with SageMaker AI training jobs.
INFERENCE: The image version is compatible with SageMaker AI inference jobs.
NOTEBOOK_KERNEL: The image version is compatible with SageMaker AI notebook kernels.
The machine learning framework vended in the image version.
* @public */ MLFramework?: string | undefined; /** *The supported programming language and its version.
* @public */ ProgrammingLang?: string | undefined; /** *Indicates CPU or GPU compatibility.
CPU: The image version is compatible with CPU.
GPU: The image version is compatible with GPU.
Indicates Horovod compatibility.
* @public */ Horovod?: boolean | undefined; /** *The maintainer description of the image version.
* @public */ ReleaseNotes?: string | undefined; } /** * @public */ export interface DescribeInferenceComponentInput { /** *The name of the inference component.
* @public */ InferenceComponentName: string | undefined; } /** * @public * @enum */ export declare const InferenceComponentStatus: { readonly CREATING: "Creating"; readonly DELETING: "Deleting"; readonly FAILED: "Failed"; readonly IN_SERVICE: "InService"; readonly UPDATING: "Updating"; }; /** * @public */ export type InferenceComponentStatus = (typeof InferenceComponentStatus)[keyof typeof InferenceComponentStatus]; /** * @public * @enum */ export declare const InferenceComponentCapacitySizeType: { readonly CAPACITY_PERCENT: "CAPACITY_PERCENT"; readonly COPY_COUNT: "COPY_COUNT"; }; /** * @public */ export type InferenceComponentCapacitySizeType = (typeof InferenceComponentCapacitySizeType)[keyof typeof InferenceComponentCapacitySizeType]; /** *Specifies the type and size of the endpoint capacity to activate for a rolling deployment or a rollback strategy. You can specify your batches as either of the following:
A count of inference component copies
The overall percentage or your fleet
For a rollback strategy, if you don't specify the fields in this object, or if you set the Value parameter to 100%, then SageMaker AI uses a blue/green rollback strategy and rolls all traffic back to the blue fleet.
Specifies the endpoint capacity type.
The endpoint activates based on the number of inference component copies.
The endpoint activates based on the specified percentage of capacity.
Defines the capacity size, either as a number of inference component copies or a capacity percentage.
* @public */ Value: number | undefined; } /** *Specifies a rolling deployment strategy for updating a SageMaker AI inference component.
* @public */ export interface InferenceComponentRollingUpdatePolicy { /** *The batch size for each rolling step in the deployment process. For each step, SageMaker AI provisions capacity on the new endpoint fleet, routes traffic to that fleet, and terminates capacity on the old endpoint fleet. The value must be between 5% to 50% of the copy count of the inference component.
* @public */ MaximumBatchSize: InferenceComponentCapacitySize | undefined; /** *The length of the baking period, during which SageMaker AI monitors alarms for each batch on the new fleet.
* @public */ WaitIntervalInSeconds: number | undefined; /** *The time limit for the total deployment. Exceeding this limit causes a timeout.
* @public */ MaximumExecutionTimeoutInSeconds?: number | undefined; /** *The batch size for a rollback to the old endpoint fleet. If this field is absent, the value is set to the default, which is 100% of the total capacity. When the default is used, SageMaker AI provisions the entire capacity of the old fleet at once during rollback.
* @public */ RollbackMaximumBatchSize?: InferenceComponentCapacitySize | undefined; } /** *The deployment configuration for an endpoint that hosts inference components. The configuration includes the desired deployment strategy and rollback settings.
* @public */ export interface InferenceComponentDeploymentConfig { /** *Specifies a rolling deployment strategy for updating a SageMaker AI endpoint.
* @public */ RollingUpdatePolicy: InferenceComponentRollingUpdatePolicy | undefined; /** *Automatic rollback configuration for handling endpoint deployment failures and recovery.
* @public */ AutoRollbackConfiguration?: AutoRollbackConfig | undefined; } /** *Details about the runtime settings for the model that is deployed with the inference component.
* @public */ export interface InferenceComponentRuntimeConfigSummary { /** *The number of runtime copies of the model container that you requested to deploy with the inference component.
* @public */ DesiredCopyCount?: number | undefined; /** *The number of runtime copies of the model container that are currently deployed.
* @public */ CurrentCopyCount?: number | undefined; } /** *Details about the resources that are deployed with this inference component.
* @public */ export interface InferenceComponentContainerSpecificationSummary { /** *Gets the Amazon EC2 Container Registry path of the docker image of the model that is hosted in this ProductionVariant.
If you used the registry/repository[:tag] form to specify the image path of the primary container when you created the model hosted in this ProductionVariant, the path resolves to a path of the form registry/repository[@digest]. A digest is a hash value that identifies a specific version of an image. For information about Amazon ECR paths, see Pulling an Image in the Amazon ECR User Guide.
The Amazon S3 path where the model artifacts are stored.
* @public */ ArtifactUrl?: string | undefined; /** *The environment variables to set in the Docker container.
* @public */ Environment?: RecordDetails about the resources that are deployed with this inference component.
* @public */ export interface InferenceComponentSpecificationSummary { /** *The name of the SageMaker AI model object that is deployed with the inference component.
* @public */ ModelName?: string | undefined; /** *Details about the container that provides the runtime environment for the model that is deployed with the inference component.
* @public */ Container?: InferenceComponentContainerSpecificationSummary | undefined; /** *Settings that take effect while the model container starts up.
* @public */ StartupParameters?: InferenceComponentStartupParameters | undefined; /** *The compute resources allocated to run the model, plus any adapter models, that you assign to the inference component.
* @public */ ComputeResourceRequirements?: InferenceComponentComputeResourceRequirements | undefined; /** *The name of the base inference component that contains this inference component.
* @public */ BaseInferenceComponentName?: string | undefined; } /** * @public */ export interface DescribeInferenceComponentOutput { /** *The name of the inference component.
* @public */ InferenceComponentName: string | undefined; /** *The Amazon Resource Name (ARN) of the inference component.
* @public */ InferenceComponentArn: string | undefined; /** *The name of the endpoint that hosts the inference component.
* @public */ EndpointName: string | undefined; /** *The Amazon Resource Name (ARN) of the endpoint that hosts the inference component.
* @public */ EndpointArn: string | undefined; /** *The name of the production variant that hosts the inference component.
* @public */ VariantName?: string | undefined; /** *If the inference component status is Failed, the reason for the failure.
Details about the resources that are deployed with this inference component.
* @public */ Specification?: InferenceComponentSpecificationSummary | undefined; /** *Details about the runtime settings for the model that is deployed with the inference component.
* @public */ RuntimeConfig?: InferenceComponentRuntimeConfigSummary | undefined; /** *The time when the inference component was created.
* @public */ CreationTime: Date | undefined; /** *The time when the inference component was last updated.
* @public */ LastModifiedTime: Date | undefined; /** *The status of the inference component.
* @public */ InferenceComponentStatus?: InferenceComponentStatus | undefined; /** *The deployment and rollback settings that you assigned to the inference component.
* @public */ LastDeploymentConfig?: InferenceComponentDeploymentConfig | undefined; } /** * @public */ export interface DescribeInferenceExperimentRequest { /** *The name of the inference experiment to describe.
* @public */ Name: string | undefined; } /** *The metadata of the endpoint.
* @public */ export interface EndpointMetadata { /** *The name of the endpoint.
* @public */ EndpointName: string | undefined; /** *The name of the endpoint configuration.
* @public */ EndpointConfigName?: string | undefined; /** *The status of the endpoint. For possible values of the status of an endpoint, see EndpointSummary.
* @public */ EndpointStatus?: EndpointStatus | undefined; /** * If the status of the endpoint is Failed, or the status is InService but update operation fails, this provides the reason why it failed.
Summary of the deployment configuration of a model.
* @public */ export interface ModelVariantConfigSummary { /** *The name of the Amazon SageMaker Model entity.
* @public */ ModelName: string | undefined; /** *The name of the variant.
* @public */ VariantName: string | undefined; /** *The configuration of the infrastructure that the model has been deployed to.
* @public */ InfrastructureConfig: ModelInfrastructureConfig | undefined; /** *The status of deployment for the model variant on the hosted inference endpoint.
Creating - Amazon SageMaker is preparing the model variant on the hosted inference endpoint.
InService - The model variant is running on the hosted inference endpoint.
Updating - Amazon SageMaker is updating the model variant on the hosted inference endpoint.
Deleting - Amazon SageMaker is deleting the model variant on the hosted inference endpoint.
Deleted - The model variant has been deleted on the hosted inference endpoint. This can only happen after stopping the experiment.
The ARN of the inference experiment being described.
* @public */ Arn: string | undefined; /** *The name of the inference experiment.
* @public */ Name: string | undefined; /** *The type of the inference experiment.
* @public */ Type: InferenceExperimentType | undefined; /** *The duration for which the inference experiment ran or will run.
* @public */ Schedule?: InferenceExperimentSchedule | undefined; /** *The status of the inference experiment. The following are the possible statuses for an inference experiment:
Creating - Amazon SageMaker is creating your experiment.
Created - Amazon SageMaker has finished the creation of your experiment and will begin the experiment at the scheduled time.
Updating - When you make changes to your experiment, your experiment shows as updating.
Starting - Amazon SageMaker is beginning your experiment.
Running - Your experiment is in progress.
Stopping - Amazon SageMaker is stopping your experiment.
Completed - Your experiment has completed.
Cancelled - When you conclude your experiment early using the StopInferenceExperiment API, or if any operation fails with an unexpected error, it shows as cancelled.
The error message or client-specified Reason from the StopInferenceExperiment API, that explains the status of the inference experiment.
The description of the inference experiment.
* @public */ Description?: string | undefined; /** *The timestamp at which you created the inference experiment.
* @public */ CreationTime?: Date | undefined; /** *The timestamp at which the inference experiment was completed.
* @public */ CompletionTime?: Date | undefined; /** *The timestamp at which you last modified the inference experiment.
* @public */ LastModifiedTime?: Date | undefined; /** *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.
* @public */ RoleArn?: string | undefined; /** *The metadata of the endpoint on which the inference experiment ran.
* @public */ EndpointMetadata: EndpointMetadata | undefined; /** * 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.
The Amazon S3 location and configuration for storing inference request and response data.
* @public */ DataStorageConfig?: InferenceExperimentDataStorageConfig | undefined; /** * 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.
The Amazon Web Services Key Management Service (Amazon Web Services KMS) key that Amazon SageMaker uses to encrypt data on the storage volume attached to the ML compute instance that hosts the endpoint. For more information, see CreateInferenceExperiment.
* @public */ KmsKey?: string | undefined; } /** * @public */ export interface DescribeInferenceRecommendationsJobRequest { /** *The name of the job. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ JobName: string | undefined; } /** *The metrics for an existing endpoint compared in an Inference Recommender job.
* @public */ export interface InferenceMetrics { /** *The expected maximum number of requests per minute for the instance.
* @public */ MaxInvocations: number | undefined; /** *The expected model latency at maximum invocations per minute for the instance.
* @public */ ModelLatency: number | undefined; } /** *The performance results from running an Inference Recommender job on an existing endpoint.
* @public */ export interface EndpointPerformance { /** *The metrics for an existing endpoint.
* @public */ Metrics: InferenceMetrics | undefined; /** *Details about a customer endpoint that was compared in an Inference Recommender job.
* @public */ EndpointInfo: EndpointInfo | undefined; } /** *The endpoint configuration made by Inference Recommender during a recommendation job.
* @public */ export interface EndpointOutputConfiguration { /** *The name of the endpoint made during a recommendation job.
* @public */ EndpointName: string | undefined; /** *The name of the production variant (deployed model) made during a recommendation job.
* @public */ VariantName: string | undefined; /** *The instance type recommended by Amazon SageMaker Inference Recommender.
* @public */ InstanceType?: ProductionVariantInstanceType | undefined; /** *The number of instances recommended to launch initially.
* @public */ InitialInstanceCount?: number | undefined; /** *Specifies the serverless configuration for an endpoint variant.
* @public */ ServerlessConfig?: ProductionVariantServerlessConfig | undefined; } /** *The metrics of recommendations.
* @public */ export interface RecommendationMetrics { /** *Defines the cost per hour for the instance.
* @public */ CostPerHour?: number | undefined; /** *Defines the cost per inference for the instance .
* @public */ CostPerInference?: number | undefined; /** *The expected maximum number of requests per minute for the instance.
* @public */ MaxInvocations?: number | undefined; /** *The expected model latency at maximum invocation per minute for the instance.
* @public */ ModelLatency?: number | undefined; /** *The expected CPU utilization at maximum invocations per minute for the instance.
NaN indicates that the value is not available.
The expected memory utilization at maximum invocations per minute for the instance.
NaN indicates that the value is not available.
The time it takes to launch new compute resources for a serverless endpoint. The time can vary depending on the model size, how long it takes to download the model, and the start-up time of the container.
NaN indicates that the value is not available.
A list of environment parameters suggested by the Amazon SageMaker Inference Recommender.
* @public */ export interface EnvironmentParameter { /** *The environment key suggested by the Amazon SageMaker Inference Recommender.
* @public */ Key: string | undefined; /** *The value type suggested by the Amazon SageMaker Inference Recommender.
* @public */ ValueType: string | undefined; /** *The value suggested by the Amazon SageMaker Inference Recommender.
* @public */ Value: string | undefined; } /** *Defines the model configuration. Includes the specification name and environment parameters.
* @public */ export interface ModelConfiguration { /** *The inference specification name in the model package version.
* @public */ InferenceSpecificationName?: string | undefined; /** *Defines the environment parameters that includes key, value types, and values.
* @public */ EnvironmentParameters?: EnvironmentParameter[] | undefined; /** *The name of the compilation job used to create the recommended model artifacts.
* @public */ CompilationJobName?: string | undefined; } /** *A list of recommendations made by Amazon SageMaker Inference Recommender.
* @public */ export interface InferenceRecommendation { /** *The recommendation ID which uniquely identifies each recommendation.
* @public */ RecommendationId?: string | undefined; /** *The metrics used to decide what recommendation to make.
* @public */ Metrics?: RecommendationMetrics | undefined; /** *Defines the endpoint configuration parameters.
* @public */ EndpointConfiguration: EndpointOutputConfiguration | undefined; /** *Defines the model configuration.
* @public */ ModelConfiguration: ModelConfiguration | undefined; /** *A timestamp that shows when the benchmark completed.
* @public */ InvocationEndTime?: Date | undefined; /** *A timestamp that shows when the benchmark started.
* @public */ InvocationStartTime?: Date | undefined; } /** * @public * @enum */ export declare const RecommendationJobStatus: { readonly COMPLETED: "COMPLETED"; readonly DELETED: "DELETED"; readonly DELETING: "DELETING"; readonly FAILED: "FAILED"; readonly IN_PROGRESS: "IN_PROGRESS"; readonly PENDING: "PENDING"; readonly STOPPED: "STOPPED"; readonly STOPPING: "STOPPING"; }; /** * @public */ export type RecommendationJobStatus = (typeof RecommendationJobStatus)[keyof typeof RecommendationJobStatus]; /** * @public */ export interface DescribeInferenceRecommendationsJobResponse { /** *The name of the job. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ JobName: string | undefined; /** *The job description that you provided when you initiated the job.
* @public */ JobDescription?: string | undefined; /** *The job type that you provided when you initiated the job.
* @public */ JobType: RecommendationJobType | undefined; /** *The Amazon Resource Name (ARN) of the job.
* @public */ JobArn: string | undefined; /** *The Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) role you provided when you initiated the job.
* @public */ RoleArn: string | undefined; /** *The status of the job.
* @public */ Status: RecommendationJobStatus | undefined; /** *A timestamp that shows when the job was created.
* @public */ CreationTime: Date | undefined; /** *A timestamp that shows when the job completed.
* @public */ CompletionTime?: Date | undefined; /** *A timestamp that shows when the job was last modified.
* @public */ LastModifiedTime: Date | undefined; /** *If the job fails, provides information why the job failed.
* @public */ FailureReason?: string | undefined; /** *Returns information about the versioned model package Amazon Resource Name (ARN), the traffic pattern, and endpoint configurations you provided when you initiated the job.
* @public */ InputConfig: RecommendationJobInputConfig | undefined; /** *The stopping conditions that you provided when you initiated the job.
* @public */ StoppingConditions?: RecommendationJobStoppingConditions | undefined; /** *The recommendations made by Inference Recommender.
* @public */ InferenceRecommendations?: InferenceRecommendation[] | undefined; /** *The performance results from running an Inference Recommender job on an existing endpoint.
* @public */ EndpointPerformances?: EndpointPerformance[] | undefined; } /** * @public */ export interface DescribeLabelingJobRequest { /** *The name of the labeling job to return information for.
* @public */ LabelingJobName: string | undefined; } /** *Provides a breakdown of the number of objects labeled.
* @public */ export interface LabelCounters { /** *The total number of objects labeled.
* @public */ TotalLabeled?: number | undefined; /** *The total number of objects labeled by a human worker.
* @public */ HumanLabeled?: number | undefined; /** *The total number of objects labeled by automated data labeling.
* @public */ MachineLabeled?: number | undefined; /** *The total number of objects that could not be labeled due to an error.
* @public */ FailedNonRetryableError?: number | undefined; /** *The total number of objects not yet labeled.
* @public */ Unlabeled?: number | undefined; } /** *Specifies the location of the output produced by the labeling job.
* @public */ export interface LabelingJobOutput { /** *The Amazon S3 bucket location of the manifest file for labeled data.
* @public */ OutputDatasetS3Uri: string | undefined; /** *The Amazon Resource Name (ARN) for the most recent SageMaker model trained as part of automated data labeling.
* @public */ FinalActiveLearningModelArn?: string | undefined; } /** * @public * @enum */ export declare const LabelingJobStatus: { readonly COMPLETED: "Completed"; readonly FAILED: "Failed"; readonly INITIALIZING: "Initializing"; readonly IN_PROGRESS: "InProgress"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; }; /** * @public */ export type LabelingJobStatus = (typeof LabelingJobStatus)[keyof typeof LabelingJobStatus]; /** * @public */ export interface DescribeLabelingJobResponse { /** *The processing status of the labeling job.
* @public */ LabelingJobStatus: LabelingJobStatus | undefined; /** *Provides a breakdown of the number of data objects labeled by humans, the number of objects labeled by machine, the number of objects than couldn't be labeled, and the total number of objects labeled.
* @public */ LabelCounters: LabelCounters | undefined; /** *If the job failed, the reason that it failed.
* @public */ FailureReason?: string | undefined; /** *The date and time that the labeling job was created.
* @public */ CreationTime: Date | undefined; /** *The date and time that the labeling job was last updated.
* @public */ LastModifiedTime: Date | undefined; /** *A unique identifier for work done as part of a labeling job.
* @public */ JobReferenceCode: string | undefined; /** *The name assigned to the labeling job when it was created.
* @public */ LabelingJobName: string | undefined; /** *The Amazon Resource Name (ARN) of the labeling job.
* @public */ LabelingJobArn: string | undefined; /** *The attribute used as the label in the output manifest file.
* @public */ LabelAttributeName?: string | undefined; /** *Input configuration information for the labeling job, such as the Amazon S3 location of the data objects and the location of the manifest file that describes the data objects.
* @public */ InputConfig: LabelingJobInputConfig | undefined; /** *The location of the job's output data and the Amazon Web Services Key Management Service key ID for the key used to encrypt the output data, if any.
* @public */ OutputConfig: LabelingJobOutputConfig | undefined; /** *The Amazon Resource Name (ARN) that SageMaker assumes to perform tasks on your behalf during data labeling.
* @public */ RoleArn: string | undefined; /** *The S3 location of the JSON file that defines the categories used to label data objects. Please note the following label-category limits:
Semantic segmentation labeling jobs using automated labeling: 20 labels
Box bounding labeling jobs (all): 10 labels
The file is a JSON structure in the following format:
\{
"document-version": "2018-11-28"
"labels": [
\{
"label": "label 1"
\},
\{
"label": "label 2"
\},
...
\{
"label": "label n"
\}
]
\}
A set of conditions for stopping a labeling job. If any of the conditions are met, the job is automatically stopped.
* @public */ StoppingConditions?: LabelingJobStoppingConditions | undefined; /** *Configuration information for automated data labeling.
* @public */ LabelingJobAlgorithmsConfig?: LabelingJobAlgorithmsConfig | undefined; /** *Configuration information required for human workers to complete a labeling task.
* @public */ HumanTaskConfig: HumanTaskConfig | undefined; /** *An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in different ways, for example, by purpose, owner, or environment. For more information, see Tagging Amazon Web Services Resources.
* @public */ Tags?: Tag[] | undefined; /** *The location of the output produced by the labeling job.
* @public */ LabelingJobOutput?: LabelingJobOutput | undefined; } /** * @public */ export interface DescribeLineageGroupRequest { /** *The name of the lineage group.
* @public */ LineageGroupName: string | undefined; } /** * @public */ export interface DescribeLineageGroupResponse { /** *The name of the lineage group.
* @public */ LineageGroupName?: string | undefined; /** *The Amazon Resource Name (ARN) of the lineage group.
* @public */ LineageGroupArn?: string | undefined; /** *The display name of the lineage group.
* @public */ DisplayName?: string | undefined; /** *The description of the lineage group.
* @public */ Description?: string | undefined; /** *The creation time of lineage group.
* @public */ CreationTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy?: UserContext | undefined; /** *The last modified time of the lineage group.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; } /** * @public */ export interface DescribeMlflowTrackingServerRequest { /** *The name of the MLflow Tracking Server to describe.
* @public */ TrackingServerName: string | undefined; } /** * @public * @enum */ export declare const IsTrackingServerActive: { readonly ACTIVE: "Active"; readonly INACTIVE: "Inactive"; }; /** * @public */ export type IsTrackingServerActive = (typeof IsTrackingServerActive)[keyof typeof IsTrackingServerActive]; /** * @public * @enum */ export declare const TrackingServerMaintenanceStatus: { readonly MAINTENANCE_COMPLETE: "MaintenanceComplete"; readonly MAINTENANCE_FAILED: "MaintenanceFailed"; readonly MAINTENANCE_IN_PROGRESS: "MaintenanceInProgress"; }; /** * @public */ export type TrackingServerMaintenanceStatus = (typeof TrackingServerMaintenanceStatus)[keyof typeof TrackingServerMaintenanceStatus]; /** * @public * @enum */ export declare const TrackingServerStatus: { readonly CREATED: "Created"; readonly CREATE_FAILED: "CreateFailed"; readonly CREATING: "Creating"; readonly DELETE_FAILED: "DeleteFailed"; readonly DELETING: "Deleting"; readonly MAINTENANCE_COMPLETE: "MaintenanceComplete"; readonly MAINTENANCE_FAILED: "MaintenanceFailed"; readonly MAINTENANCE_IN_PROGRESS: "MaintenanceInProgress"; readonly STARTED: "Started"; readonly STARTING: "Starting"; readonly START_FAILED: "StartFailed"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; readonly STOP_FAILED: "StopFailed"; readonly UPDATED: "Updated"; readonly UPDATE_FAILED: "UpdateFailed"; readonly UPDATING: "Updating"; }; /** * @public */ export type TrackingServerStatus = (typeof TrackingServerStatus)[keyof typeof TrackingServerStatus]; /** * @public */ export interface DescribeMlflowTrackingServerResponse { /** *The ARN of the described tracking server.
* @public */ TrackingServerArn?: string | undefined; /** *The name of the described tracking server.
* @public */ TrackingServerName?: string | undefined; /** *The S3 URI of the general purpose bucket used as the MLflow Tracking Server artifact store.
* @public */ ArtifactStoreUri?: string | undefined; /** *The size of the described tracking server.
* @public */ TrackingServerSize?: TrackingServerSize | undefined; /** *The MLflow version used for the described tracking server.
* @public */ MlflowVersion?: string | undefined; /** *The Amazon Resource Name (ARN) for an IAM role in your account that the described MLflow Tracking Server uses to access the artifact store in Amazon S3.
* @public */ RoleArn?: string | undefined; /** *The current creation status of the described MLflow Tracking Server.
* @public */ TrackingServerStatus?: TrackingServerStatus | undefined; /** *The current maintenance status of the described MLflow Tracking Server.
* @public */ TrackingServerMaintenanceStatus?: TrackingServerMaintenanceStatus | undefined; /** *Whether the described MLflow Tracking Server is currently active.
* @public */ IsActive?: IsTrackingServerActive | undefined; /** *The URL to connect to the MLflow user interface for the described tracking server.
* @public */ TrackingServerUrl?: string | undefined; /** *The day and time of the week when weekly maintenance occurs on the described tracking server.
* @public */ WeeklyMaintenanceWindowStart?: string | undefined; /** *Whether automatic registration of new MLflow models to the SageMaker Model Registry is enabled.
* @public */ AutomaticModelRegistration?: boolean | undefined; /** *The timestamp of when the described MLflow Tracking Server was created.
* @public */ CreationTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy?: UserContext | undefined; /** *The timestamp of when the described MLflow Tracking Server was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; } /** * @public */ export interface DescribeModelInput { /** *The name of the model.
* @public */ ModelName: string | undefined; } /** * @public */ export interface DescribeModelOutput { /** *Name of the SageMaker model.
* @public */ ModelName: string | undefined; /** *The location of the primary inference code, associated artifacts, and custom environment map that the inference code uses when it is deployed in production.
* @public */ PrimaryContainer?: ContainerDefinition | undefined; /** *The containers in the inference pipeline.
* @public */ Containers?: ContainerDefinition[] | undefined; /** *Specifies details of how containers in a multi-container endpoint are called.
* @public */ InferenceExecutionConfig?: InferenceExecutionConfig | undefined; /** *The Amazon Resource Name (ARN) of the IAM role that you specified for the model.
* @public */ ExecutionRoleArn?: string | undefined; /** *A VpcConfig object that specifies the VPC that this model has access to. For more information, see Protect Endpoints by Using an Amazon Virtual Private Cloud
* @public */ VpcConfig?: VpcConfig | undefined; /** *A timestamp that shows when the model was created.
* @public */ CreationTime: Date | undefined; /** *The Amazon Resource Name (ARN) of the model.
* @public */ ModelArn: string | undefined; /** *If True, no inbound or outbound network calls can be made to or from the model container.
A set of recommended deployment configurations for the model.
* @public */ DeploymentRecommendation?: DeploymentRecommendation | undefined; } /** * @public */ export interface DescribeModelBiasJobDefinitionRequest { /** *The name of the model bias job definition. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ JobDefinitionName: string | undefined; } /** * @public */ export interface DescribeModelBiasJobDefinitionResponse { /** *The Amazon Resource Name (ARN) of the model bias job.
* @public */ JobDefinitionArn: string | undefined; /** *The name of the bias job definition. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ JobDefinitionName: string | undefined; /** *The time at which the model bias job was created.
* @public */ CreationTime: Date | undefined; /** *The baseline configuration for a model bias job.
* @public */ ModelBiasBaselineConfig?: ModelBiasBaselineConfig | undefined; /** *Configures the model bias job to run a specified Docker container image.
* @public */ ModelBiasAppSpecification: ModelBiasAppSpecification | undefined; /** *Inputs for the model bias job.
* @public */ ModelBiasJobInput: ModelBiasJobInput | undefined; /** *The output configuration for monitoring jobs.
* @public */ ModelBiasJobOutputConfig: MonitoringOutputConfig | undefined; /** *Identifies the resources to deploy for a monitoring job.
* @public */ JobResources: MonitoringResources | undefined; /** *Networking options for a model bias job.
* @public */ NetworkConfig?: MonitoringNetworkConfig | undefined; /** *The Amazon Resource Name (ARN) of the IAM role that has read permission to the input data location and write permission to the output data location in Amazon S3.
* @public */ RoleArn: string | undefined; /** *A time limit for how long the monitoring job is allowed to run before stopping.
* @public */ StoppingCondition?: MonitoringStoppingCondition | undefined; } /** * @public */ export interface DescribeModelCardRequest { /** *The name or Amazon Resource Name (ARN) of the model card to describe.
* @public */ ModelCardName: string | undefined; /** *The version of the model card to describe. If a version is not provided, then the latest version of the model card is described.
* @public */ ModelCardVersion?: number | undefined; } /** * @public * @enum */ export declare const ModelCardProcessingStatus: { readonly CONTENT_DELETED: "ContentDeleted"; readonly DELETE_COMPLETED: "DeleteCompleted"; readonly DELETE_FAILED: "DeleteFailed"; readonly DELETE_INPROGRESS: "DeleteInProgress"; readonly DELETE_PENDING: "DeletePending"; readonly EXPORTJOBS_DELETED: "ExportJobsDeleted"; }; /** * @public */ export type ModelCardProcessingStatus = (typeof ModelCardProcessingStatus)[keyof typeof ModelCardProcessingStatus]; /** * @public */ export interface DescribeModelCardResponse { /** *The Amazon Resource Name (ARN) of the model card.
* @public */ ModelCardArn: string | undefined; /** *The name of the model card.
* @public */ ModelCardName: string | undefined; /** *The version of the model card.
* @public */ ModelCardVersion: number | undefined; /** *The content of the model card.
* @public */ Content: string | undefined; /** *The approval status of the model card within your organization. Different organizations might have different criteria for model card review and approval.
Draft: The model card is a work in progress.
PendingReview: The model card is pending review.
Approved: The model card is approved.
Archived: The model card is archived. No more updates should be made to the model card, but it can still be exported.
The security configuration used to protect model card content.
* @public */ SecurityConfig?: ModelCardSecurityConfig | undefined; /** *The date and time the model card was created.
* @public */ CreationTime: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy: UserContext | undefined; /** *The date and time the model card was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; /** *The processing status of model card deletion. The ModelCardProcessingStatus updates throughout the different deletion steps.
DeletePending: Model card deletion request received.
DeleteInProgress: Model card deletion is in progress.
ContentDeleted: Deleted model card content.
ExportJobsDeleted: Deleted all export jobs associated with the model card.
DeleteCompleted: Successfully deleted the model card.
DeleteFailed: The model card failed to delete.
The Amazon Resource Name (ARN) of the model card export job to describe.
* @public */ ModelCardExportJobArn: string | undefined; } /** *The artifacts of the model card export job.
* @public */ export interface ModelCardExportArtifacts { /** *The Amazon S3 URI of the exported model artifacts.
* @public */ S3ExportArtifacts: string | undefined; } /** * @public * @enum */ export declare const ModelCardExportJobStatus: { readonly COMPLETED: "Completed"; readonly FAILED: "Failed"; readonly IN_PROGRESS: "InProgress"; }; /** * @public */ export type ModelCardExportJobStatus = (typeof ModelCardExportJobStatus)[keyof typeof ModelCardExportJobStatus]; /** * @public */ export interface DescribeModelCardExportJobResponse { /** *The name of the model card export job to describe.
* @public */ ModelCardExportJobName: string | undefined; /** *The Amazon Resource Name (ARN) of the model card export job.
* @public */ ModelCardExportJobArn: string | undefined; /** *The completion status of the model card export job.
InProgress: The model card export job is in progress.
Completed: The model card export job is complete.
Failed: The model card export job failed. To see the reason for the failure, see the FailureReason field in the response to a DescribeModelCardExportJob call.
The name or Amazon Resource Name (ARN) of the model card that the model export job exports.
* @public */ ModelCardName: string | undefined; /** *The version of the model card that the model export job exports.
* @public */ ModelCardVersion: number | undefined; /** *The export output details for the model card.
* @public */ OutputConfig: ModelCardExportOutputConfig | undefined; /** *The date and time that the model export job was created.
* @public */ CreatedAt: Date | undefined; /** *The date and time that the model export job was last modified.
* @public */ LastModifiedAt: Date | undefined; /** *The failure reason if the model export job fails.
* @public */ FailureReason?: string | undefined; /** *The exported model card artifacts.
* @public */ ExportArtifacts?: ModelCardExportArtifacts | undefined; } /** * @public */ export interface DescribeModelExplainabilityJobDefinitionRequest { /** *The name of the model explainability job definition. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ JobDefinitionName: string | undefined; } /** * @public */ export interface DescribeModelExplainabilityJobDefinitionResponse { /** *The Amazon Resource Name (ARN) of the model explainability job.
* @public */ JobDefinitionArn: string | undefined; /** *The name of the explainability job definition. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ JobDefinitionName: string | undefined; /** *The time at which the model explainability job was created.
* @public */ CreationTime: Date | undefined; /** *The baseline configuration for a model explainability job.
* @public */ ModelExplainabilityBaselineConfig?: ModelExplainabilityBaselineConfig | undefined; /** *Configures the model explainability job to run a specified Docker container image.
* @public */ ModelExplainabilityAppSpecification: ModelExplainabilityAppSpecification | undefined; /** *Inputs for the model explainability job.
* @public */ ModelExplainabilityJobInput: ModelExplainabilityJobInput | undefined; /** *The output configuration for monitoring jobs.
* @public */ ModelExplainabilityJobOutputConfig: MonitoringOutputConfig | undefined; /** *Identifies the resources to deploy for a monitoring job.
* @public */ JobResources: MonitoringResources | undefined; /** *Networking options for a model explainability job.
* @public */ NetworkConfig?: MonitoringNetworkConfig | undefined; /** *The Amazon Resource Name (ARN) of the IAM role that has read permission to the input data location and write permission to the output data location in Amazon S3.
* @public */ RoleArn: string | undefined; /** *A time limit for how long the monitoring job is allowed to run before stopping.
* @public */ StoppingCondition?: MonitoringStoppingCondition | undefined; } /** * @public */ export interface DescribeModelPackageInput { /** *The name or Amazon Resource Name (ARN) of the model package to describe.
When you specify a name, the name must have 1 to 63 characters. Valid characters are a-z, A-Z, 0-9, and - (hyphen).
* @public */ ModelPackageName: string | undefined; } /** * @public * @enum */ export declare const DetailedModelPackageStatus: { readonly COMPLETED: "Completed"; readonly FAILED: "Failed"; readonly IN_PROGRESS: "InProgress"; readonly NOT_STARTED: "NotStarted"; }; /** * @public */ export type DetailedModelPackageStatus = (typeof DetailedModelPackageStatus)[keyof typeof DetailedModelPackageStatus]; /** *Represents the overall status of a model package.
* @public */ export interface ModelPackageStatusItem { /** *The name of the model package for which the overall status is being reported.
* @public */ Name: string | undefined; /** *The current status.
* @public */ Status: DetailedModelPackageStatus | undefined; /** *if the overall status is Failed, the reason for the failure.
Specifies the validation and image scan statuses of the model package.
* @public */ export interface ModelPackageStatusDetails { /** *The validation status of the model package.
* @public */ ValidationStatuses: ModelPackageStatusItem[] | undefined; /** *The status of the scan of the Docker image container for the model package.
* @public */ ImageScanStatuses?: ModelPackageStatusItem[] | undefined; } /** * @public */ export interface DescribeModelPackageOutput { /** *The name of the model package being described.
* @public */ ModelPackageName: string | undefined; /** *If the model is a versioned model, the name of the model group that the versioned model belongs to.
* @public */ ModelPackageGroupName?: string | undefined; /** *The version of the model package.
* @public */ ModelPackageVersion?: number | undefined; /** *The Amazon Resource Name (ARN) of the model package.
* @public */ ModelPackageArn: string | undefined; /** *A brief summary of the model package.
* @public */ ModelPackageDescription?: string | undefined; /** *A timestamp specifying when the model package was created.
* @public */ CreationTime: Date | undefined; /** *Details about inference jobs that you can run with models based on this model package.
* @public */ InferenceSpecification?: InferenceSpecification | undefined; /** *Details about the algorithm that was used to create the model package.
* @public */ SourceAlgorithmSpecification?: SourceAlgorithmSpecification | undefined; /** *Configurations for one or more transform jobs that SageMaker runs to test the model package.
* @public */ ValidationSpecification?: ModelPackageValidationSpecification | undefined; /** *The current status of the model package.
* @public */ ModelPackageStatus: ModelPackageStatus | undefined; /** *Details about the current status of the model package.
* @public */ ModelPackageStatusDetails: ModelPackageStatusDetails | undefined; /** *Whether the model package is certified for listing on Amazon Web Services Marketplace.
* @public */ CertifyForMarketplace?: boolean | undefined; /** *The approval status of the model package.
* @public */ ModelApprovalStatus?: ModelApprovalStatus | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy?: UserContext | undefined; /** *Metadata properties of the tracking entity, trial, or trial component.
* @public */ MetadataProperties?: MetadataProperties | undefined; /** *Metrics for the model.
* @public */ ModelMetrics?: ModelMetrics | undefined; /** *The last time that the model package was modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; /** *A description provided for the model approval.
* @public */ ApprovalDescription?: string | undefined; /** *The machine learning domain of the model package you specified. Common machine learning domains include computer vision and natural language processing.
* @public */ Domain?: string | undefined; /** *The machine learning task you specified that your model package accomplishes. Common machine learning tasks include object detection and image classification.
* @public */ Task?: string | undefined; /** *The Amazon Simple Storage Service (Amazon S3) path where the sample payload are stored. This path points to a single gzip compressed tar archive (.tar.gz suffix).
* @public */ SamplePayloadUrl?: string | undefined; /** *The metadata properties associated with the model package versions.
* @public */ CustomerMetadataProperties?: RecordRepresents the drift check baselines that can be used when the model monitor is set using the model package. For more information, see the topic on Drift Detection against Previous Baselines in SageMaker Pipelines in the Amazon SageMaker Developer Guide.
* @public */ DriftCheckBaselines?: DriftCheckBaselines | undefined; /** *An array of additional Inference Specification objects. Each additional Inference Specification specifies artifacts based on this model package that can be used on inference endpoints. Generally used with SageMaker Neo to store the compiled artifacts.
* @public */ AdditionalInferenceSpecifications?: AdditionalInferenceSpecificationDefinition[] | undefined; /** *Indicates if you want to skip model validation.
* @public */ SkipModelValidation?: SkipModelValidation | undefined; /** *The URI of the source for the model package.
* @public */ SourceUri?: string | undefined; /** *The KMS Key ID (KMSKeyId) used for encryption of model package information.
The model card associated with the model package. Since ModelPackageModelCard is tied to a model package, it is a specific usage of a model card and its schema is simplified compared to the schema of ModelCard. The ModelPackageModelCard schema does not include model_package_details, and model_overview is composed of the model_creator and model_artifact properties. For more information about the model package model card schema, see Model package model card schema. For more information about the model card associated with the model package, see View the Details of a Model Version.
A structure describing the current state of the model in its life cycle.
* @public */ ModelLifeCycle?: ModelLifeCycle | undefined; } /** * @public */ export interface DescribeModelPackageGroupInput { /** *The name of the model group to describe.
* @public */ ModelPackageGroupName: string | undefined; } /** * @public * @enum */ export declare const ModelPackageGroupStatus: { readonly COMPLETED: "Completed"; readonly DELETE_FAILED: "DeleteFailed"; readonly DELETING: "Deleting"; readonly FAILED: "Failed"; readonly IN_PROGRESS: "InProgress"; readonly PENDING: "Pending"; }; /** * @public */ export type ModelPackageGroupStatus = (typeof ModelPackageGroupStatus)[keyof typeof ModelPackageGroupStatus]; /** * @public */ export interface DescribeModelPackageGroupOutput { /** *The name of the model group.
* @public */ ModelPackageGroupName: string | undefined; /** *The Amazon Resource Name (ARN) of the model group.
* @public */ ModelPackageGroupArn: string | undefined; /** *A description of the model group.
* @public */ ModelPackageGroupDescription?: string | undefined; /** *The time that the model group was created.
* @public */ CreationTime: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy: UserContext | undefined; /** *The status of the model group.
* @public */ ModelPackageGroupStatus: ModelPackageGroupStatus | undefined; } /** * @public */ export interface DescribeModelQualityJobDefinitionRequest { /** *The name of the model quality job. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ JobDefinitionName: string | undefined; } /** * @public */ export interface DescribeModelQualityJobDefinitionResponse { /** *The Amazon Resource Name (ARN) of the model quality job.
* @public */ JobDefinitionArn: string | undefined; /** *The name of the quality job definition. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ JobDefinitionName: string | undefined; /** *The time at which the model quality job was created.
* @public */ CreationTime: Date | undefined; /** *The baseline configuration for a model quality job.
* @public */ ModelQualityBaselineConfig?: ModelQualityBaselineConfig | undefined; /** *Configures the model quality job to run a specified Docker container image.
* @public */ ModelQualityAppSpecification: ModelQualityAppSpecification | undefined; /** *Inputs for the model quality job.
* @public */ ModelQualityJobInput: ModelQualityJobInput | undefined; /** *The output configuration for monitoring jobs.
* @public */ ModelQualityJobOutputConfig: MonitoringOutputConfig | undefined; /** *Identifies the resources to deploy for a monitoring job.
* @public */ JobResources: MonitoringResources | undefined; /** *Networking options for a model quality job.
* @public */ NetworkConfig?: MonitoringNetworkConfig | undefined; /** *The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker AI can assume to perform tasks on your behalf.
* @public */ RoleArn: string | undefined; /** *A time limit for how long the monitoring job is allowed to run before stopping.
* @public */ StoppingCondition?: MonitoringStoppingCondition | undefined; } /** * @public */ export interface DescribeMonitoringScheduleRequest { /** *Name of a previously created monitoring schedule.
* @public */ MonitoringScheduleName: string | undefined; } /** * @public * @enum */ export declare const ExecutionStatus: { readonly COMPLETED: "Completed"; readonly COMPLETED_WITH_VIOLATIONS: "CompletedWithViolations"; readonly FAILED: "Failed"; readonly IN_PROGRESS: "InProgress"; readonly PENDING: "Pending"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; }; /** * @public */ export type ExecutionStatus = (typeof ExecutionStatus)[keyof typeof ExecutionStatus]; /** *Summary of information about the last monitoring job to run.
* @public */ export interface MonitoringExecutionSummary { /** *The name of the monitoring schedule.
* @public */ MonitoringScheduleName: string | undefined; /** *The time the monitoring job was scheduled.
* @public */ ScheduledTime: Date | undefined; /** *The time at which the monitoring job was created.
* @public */ CreationTime: Date | undefined; /** *A timestamp that indicates the last time the monitoring job was modified.
* @public */ LastModifiedTime: Date | undefined; /** *The status of the monitoring job.
* @public */ MonitoringExecutionStatus: ExecutionStatus | undefined; /** *The Amazon Resource Name (ARN) of the monitoring job.
* @public */ ProcessingJobArn?: string | undefined; /** *The name of the endpoint used to run the monitoring job.
* @public */ EndpointName?: string | undefined; /** *Contains the reason a monitoring job failed, if it failed.
* @public */ FailureReason?: string | undefined; /** *The name of the monitoring job.
* @public */ MonitoringJobDefinitionName?: string | undefined; /** *The type of the monitoring job.
* @public */ MonitoringType?: MonitoringType | undefined; } /** * @public * @enum */ export declare const ScheduleStatus: { readonly FAILED: "Failed"; readonly PENDING: "Pending"; readonly SCHEDULED: "Scheduled"; readonly STOPPED: "Stopped"; }; /** * @public */ export type ScheduleStatus = (typeof ScheduleStatus)[keyof typeof ScheduleStatus]; /** * @public */ export interface DescribeMonitoringScheduleResponse { /** *The Amazon Resource Name (ARN) of the monitoring schedule.
* @public */ MonitoringScheduleArn: string | undefined; /** *Name of the monitoring schedule.
* @public */ MonitoringScheduleName: string | undefined; /** *The status of an monitoring job.
* @public */ MonitoringScheduleStatus: ScheduleStatus | undefined; /** *The type of the monitoring job that this schedule runs. This is one of the following values.
DATA_QUALITY - The schedule is for a data quality monitoring job.
MODEL_QUALITY - The schedule is for a model quality monitoring job.
MODEL_BIAS - The schedule is for a bias monitoring job.
MODEL_EXPLAINABILITY - The schedule is for an explainability monitoring job.
A string, up to one KB in size, that contains the reason a monitoring job failed, if it failed.
* @public */ FailureReason?: string | undefined; /** *The time at which the monitoring job was created.
* @public */ CreationTime: Date | undefined; /** *The time at which the monitoring job was last modified.
* @public */ LastModifiedTime: Date | undefined; /** *The configuration object that specifies the monitoring schedule and defines the monitoring job.
* @public */ MonitoringScheduleConfig: MonitoringScheduleConfig | undefined; /** *The name of the endpoint for the monitoring job.
* @public */ EndpointName?: string | undefined; /** *Describes metadata on the last execution to run, if there was one.
* @public */ LastMonitoringExecutionSummary?: MonitoringExecutionSummary | undefined; } /** * @public */ export interface DescribeNotebookInstanceInput { /** *The name of the notebook instance that you want information about.
* @public */ NotebookInstanceName: string | undefined; } /** * @public * @enum */ export declare const NotebookInstanceStatus: { readonly Deleting: "Deleting"; readonly Failed: "Failed"; readonly InService: "InService"; readonly Pending: "Pending"; readonly Stopped: "Stopped"; readonly Stopping: "Stopping"; readonly Updating: "Updating"; }; /** * @public */ export type NotebookInstanceStatus = (typeof NotebookInstanceStatus)[keyof typeof NotebookInstanceStatus]; /** * @public */ export interface DescribeNotebookInstanceOutput { /** *The Amazon Resource Name (ARN) of the notebook instance.
* @public */ NotebookInstanceArn?: string | undefined; /** *The name of the SageMaker AI notebook instance.
* @public */ NotebookInstanceName?: string | undefined; /** *The status of the notebook instance.
* @public */ NotebookInstanceStatus?: NotebookInstanceStatus | undefined; /** *If status is Failed, the reason it failed.
The URL that you use to connect to the Jupyter notebook that is running in your notebook instance.
* @public */ Url?: string | undefined; /** *The type of ML compute instance running on the notebook instance.
* @public */ InstanceType?: _InstanceType | undefined; /** *The ID of the VPC subnet.
* @public */ SubnetId?: string | undefined; /** *The IDs of the VPC security groups.
* @public */ SecurityGroups?: string[] | undefined; /** *The Amazon Resource Name (ARN) of the IAM role associated with the instance.
* @public */ RoleArn?: string | undefined; /** *The Amazon Web Services KMS key ID SageMaker AI uses to encrypt data when storing it on the ML storage volume attached to the instance.
* @public */ KmsKeyId?: string | undefined; /** *The network interface IDs that SageMaker AI created at the time of creating the instance.
* @public */ NetworkInterfaceId?: string | undefined; /** *A timestamp. Use this parameter to retrieve the time when the notebook instance was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *A timestamp. Use this parameter to return the time when the notebook instance was created
* @public */ CreationTime?: Date | undefined; /** *Returns the name of a notebook instance lifecycle configuration.
For information about notebook instance lifestyle configurations, see Step 2.1: (Optional) Customize a Notebook Instance
* @public */ NotebookInstanceLifecycleConfigName?: string | undefined; /** *Describes whether SageMaker AI provides internet access to the notebook instance. If this value is set to Disabled, the notebook instance does not have internet access, and cannot connect to SageMaker AI training and endpoint services.
For more information, see Notebook Instances Are Internet-Enabled by Default.
* @public */ DirectInternetAccess?: DirectInternetAccess | undefined; /** *The size, in GB, of the ML storage volume attached to the notebook instance.
* @public */ VolumeSizeInGB?: number | undefined; /** *This parameter is no longer supported. Elastic Inference (EI) is no longer available.
This parameter was used to specify a list of the EI instance types associated with this notebook instance.
* @public */ AcceleratorTypes?: NotebookInstanceAcceleratorType[] | undefined; /** *The Git repository associated with the notebook instance as its default code repository. This can be either the name of a Git repository stored as a resource in your account, or the URL of a Git repository in Amazon Web Services CodeCommit or in any other Git repository. When you open a notebook instance, it opens in the directory that contains this repository. For more information, see Associating Git Repositories with SageMaker AI Notebook Instances.
* @public */ DefaultCodeRepository?: string | undefined; /** *An array of up to three Git repositories associated with the notebook instance. These can be either the names of Git repositories stored as resources in your account, or the URL of Git repositories in Amazon Web Services CodeCommit or in any other Git repository. These repositories are cloned at the same level as the default repository of your notebook instance. For more information, see Associating Git Repositories with SageMaker AI Notebook Instances.
* @public */ AdditionalCodeRepositories?: string[] | undefined; /** *Whether root access is enabled or disabled for users of the notebook instance.
Lifecycle configurations need root access to be able to set up a notebook instance. Because of this, lifecycle configurations associated with a notebook instance always run with root access even if you disable root access for users.
The platform identifier of the notebook instance runtime environment.
* @public */ PlatformIdentifier?: string | undefined; /** *Information on the IMDS configuration of the notebook instance
* @public */ InstanceMetadataServiceConfiguration?: InstanceMetadataServiceConfiguration | undefined; } /** * @public */ export interface DescribeNotebookInstanceLifecycleConfigInput { /** *The name of the lifecycle configuration to describe.
* @public */ NotebookInstanceLifecycleConfigName: string | undefined; } /** * @public */ export interface DescribeNotebookInstanceLifecycleConfigOutput { /** *The Amazon Resource Name (ARN) of the lifecycle configuration.
* @public */ NotebookInstanceLifecycleConfigArn?: string | undefined; /** *The name of the lifecycle configuration.
* @public */ NotebookInstanceLifecycleConfigName?: string | undefined; /** *The shell script that runs only once, when you create a notebook instance.
* @public */ OnCreate?: NotebookInstanceLifecycleHook[] | undefined; /** *The shell script that runs every time you start a notebook instance, including when you create the notebook instance.
* @public */ OnStart?: NotebookInstanceLifecycleHook[] | undefined; /** *A timestamp that tells when the lifecycle configuration was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *A timestamp that tells when the lifecycle configuration was created.
* @public */ CreationTime?: Date | undefined; } /** * @public */ export interface DescribeOptimizationJobRequest { /** *The name that you assigned to the optimization job.
* @public */ OptimizationJobName: string | undefined; } /** * @public * @enum */ export declare const OptimizationJobStatus: { readonly COMPLETED: "COMPLETED"; readonly FAILED: "FAILED"; readonly INPROGRESS: "INPROGRESS"; readonly STARTING: "STARTING"; readonly STOPPED: "STOPPED"; readonly STOPPING: "STOPPING"; }; /** * @public */ export type OptimizationJobStatus = (typeof OptimizationJobStatus)[keyof typeof OptimizationJobStatus]; /** *Output values produced by an optimization job.
* @public */ export interface OptimizationOutput { /** *The image that SageMaker recommends that you use to host the optimized model that you created with an optimization job.
* @public */ RecommendedInferenceImage?: string | undefined; } /** * @public */ export interface DescribeOptimizationJobResponse { /** *The Amazon Resource Name (ARN) of the optimization job.
* @public */ OptimizationJobArn: string | undefined; /** *The current status of the optimization job.
* @public */ OptimizationJobStatus: OptimizationJobStatus | undefined; /** *The time when the optimization job started.
* @public */ OptimizationStartTime?: Date | undefined; /** *The time when the optimization job finished processing.
* @public */ OptimizationEndTime?: Date | undefined; /** *The time when you created the optimization job.
* @public */ CreationTime: Date | undefined; /** *The time when the optimization job was last updated.
* @public */ LastModifiedTime: Date | undefined; /** *If the optimization job status is FAILED, the reason for the failure.
The name that you assigned to the optimization job.
* @public */ OptimizationJobName: string | undefined; /** *The location of the source model to optimize with an optimization job.
* @public */ ModelSource: OptimizationJobModelSource | undefined; /** *The environment variables to set in the model container.
* @public */ OptimizationEnvironment?: RecordThe type of instance that hosts the optimized model that you create with the optimization job.
* @public */ DeploymentInstanceType: OptimizationJobDeploymentInstanceType | undefined; /** *Settings for each of the optimization techniques that the job applies.
* @public */ OptimizationConfigs: OptimizationConfig[] | undefined; /** *Details for where to store the optimized model that you create with the optimization job.
* @public */ OutputConfig: OptimizationJobOutputConfig | undefined; /** *Output values produced by an optimization job.
* @public */ OptimizationOutput?: OptimizationOutput | undefined; /** *The ARN of the IAM role that you assigned to the optimization job.
* @public */ RoleArn: string | undefined; /** *Specifies a limit to how long a job can run. When the job reaches the time limit, SageMaker ends the job. Use this API to cap costs.
To stop a training job, SageMaker sends the algorithm the SIGTERM signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
The training algorithms provided by SageMaker automatically save the intermediate results of a model training job when possible. This attempt to save artifacts is only a best effort case as model might not be in a state from which it can be saved. For example, if training has just started, the model might not be ready to save. When saved, this intermediate data is a valid model artifact. You can use it to create a model with CreateModel.
The Neural Topic Model (NTM) currently does not support saving intermediate model artifacts. When training NTMs, make sure that the maximum runtime is sufficient for the training job to complete.
A VPC in Amazon VPC that your optimized model has access to.
* @public */ VpcConfig?: OptimizationVpcConfig | undefined; } /** * @public */ export interface DescribePartnerAppRequest { /** *The ARN of the SageMaker Partner AI App to describe.
* @public */ Arn: string | undefined; } /** *This is an error field object that contains the error code and the reason for an operation failure.
* @public */ export interface ErrorInfo { /** *The error code for an invalid or failed operation.
* @public */ Code?: string | undefined; /** *The failure reason for the operation.
* @public */ Reason?: string | undefined; } /** * @public * @enum */ export declare const PartnerAppStatus: { readonly AVAILABLE: "Available"; readonly CREATING: "Creating"; readonly DELETED: "Deleted"; readonly DELETING: "Deleting"; readonly FAILED: "Failed"; readonly UPDATE_FAILED: "UpdateFailed"; readonly UPDATING: "Updating"; }; /** * @public */ export type PartnerAppStatus = (typeof PartnerAppStatus)[keyof typeof PartnerAppStatus]; /** * @public */ export interface DescribePartnerAppResponse { /** *The ARN of the SageMaker Partner AI App that was described.
* @public */ Arn?: string | undefined; /** *The name of the SageMaker Partner AI App.
* @public */ Name?: string | undefined; /** *The type of SageMaker Partner AI App. Must be one of the following: lakera-guard, comet, deepchecks-llm-evaluation, or fiddler.
The status of the SageMaker Partner AI App.
* @public */ Status?: PartnerAppStatus | undefined; /** *The time that the SageMaker Partner AI App was created.
* @public */ CreationTime?: Date | undefined; /** *The time that the SageMaker Partner AI App was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *The ARN of the IAM role associated with the SageMaker Partner AI App.
* @public */ ExecutionRoleArn?: string | undefined; /** *The Amazon Web Services KMS customer managed key used to encrypt the data at rest associated with SageMaker Partner AI Apps.
* @public */ KmsKeyId?: string | undefined; /** *The URL of the SageMaker Partner AI App that the Application SDK uses to support in-app calls for the user.
* @public */ BaseUrl?: string | undefined; /** *Maintenance configuration settings for the SageMaker Partner AI App.
* @public */ MaintenanceConfig?: PartnerAppMaintenanceConfig | undefined; /** *The instance type and size of the cluster attached to the SageMaker Partner AI App.
* @public */ Tier?: string | undefined; /** *The version of the SageMaker Partner AI App.
* @public */ Version?: string | undefined; /** *Configuration settings for the SageMaker Partner AI App.
* @public */ ApplicationConfig?: PartnerAppConfig | undefined; /** *The authorization type that users use to access the SageMaker Partner AI App.
* @public */ AuthType?: PartnerAppAuthType | undefined; /** *When set to TRUE, the SageMaker Partner AI App sets the Amazon Web Services IAM session name or the authenticated IAM user as the identity of the SageMaker Partner AI App user.
This is an error field object that contains the error code and the reason for an operation failure.
* @public */ Error?: ErrorInfo | undefined; } /** * @public */ export interface DescribePipelineRequest { /** *The name or Amazon Resource Name (ARN) of the pipeline to describe.
* @public */ PipelineName: string | undefined; /** *The ID of the pipeline version to describe.
* @public */ PipelineVersionId?: number | undefined; } /** * @public * @enum */ export declare const PipelineStatus: { readonly ACTIVE: "Active"; readonly DELETING: "Deleting"; }; /** * @public */ export type PipelineStatus = (typeof PipelineStatus)[keyof typeof PipelineStatus]; /** * @public */ export interface DescribePipelineResponse { /** *The Amazon Resource Name (ARN) of the pipeline.
* @public */ PipelineArn?: string | undefined; /** *The name of the pipeline.
* @public */ PipelineName?: string | undefined; /** *The display name of the pipeline.
* @public */ PipelineDisplayName?: string | undefined; /** *The JSON pipeline definition.
* @public */ PipelineDefinition?: string | undefined; /** *The description of the pipeline.
* @public */ PipelineDescription?: string | undefined; /** *The Amazon Resource Name (ARN) that the pipeline uses to execute.
* @public */ RoleArn?: string | undefined; /** *The status of the pipeline execution.
* @public */ PipelineStatus?: PipelineStatus | undefined; /** *The time when the pipeline was created.
* @public */ CreationTime?: Date | undefined; /** *The time when the pipeline was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *The time when the pipeline was last run.
* @public */ LastRunTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy?: UserContext | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; /** *Lists the parallelism configuration applied to the pipeline.
* @public */ ParallelismConfiguration?: ParallelismConfiguration | undefined; /** *The display name of the pipeline version.
* @public */ PipelineVersionDisplayName?: string | undefined; /** *The description of the pipeline version.
* @public */ PipelineVersionDescription?: string | undefined; } /** * @public */ export interface DescribePipelineDefinitionForExecutionRequest { /** *The Amazon Resource Name (ARN) of the pipeline execution.
* @public */ PipelineExecutionArn: string | undefined; } /** * @public */ export interface DescribePipelineDefinitionForExecutionResponse { /** *The JSON pipeline definition.
* @public */ PipelineDefinition?: string | undefined; /** *The time when the pipeline was created.
* @public */ CreationTime?: Date | undefined; } /** * @public */ export interface DescribePipelineExecutionRequest { /** *The Amazon Resource Name (ARN) of the pipeline execution.
* @public */ PipelineExecutionArn: string | undefined; } /** * @public * @enum */ export declare const PipelineExecutionStatus: { readonly EXECUTING: "Executing"; readonly FAILED: "Failed"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; readonly SUCCEEDED: "Succeeded"; }; /** * @public */ export type PipelineExecutionStatus = (typeof PipelineExecutionStatus)[keyof typeof PipelineExecutionStatus]; /** *Specifies the names of the experiment and trial created by a pipeline.
* @public */ export interface PipelineExperimentConfig { /** *The name of the experiment.
* @public */ ExperimentName?: string | undefined; /** *The name of the trial.
* @public */ TrialName?: string | undefined; } /** *A step selected to run in selective execution mode.
* @public */ export interface SelectedStep { /** *The name of the pipeline step.
* @public */ StepName: string | undefined; } /** *The selective execution configuration applied to the pipeline run.
* @public */ export interface SelectiveExecutionConfig { /** *The ARN from a reference execution of the current pipeline. Used to copy input collaterals needed for the selected steps to run. The execution status of the pipeline can be either Failed or Success.
This field is required if the steps you specify for SelectedSteps depend on output collaterals from any non-specified pipeline steps. For more information, see Selective Execution for Pipeline Steps.
A list of pipeline steps to run. All step(s) in all path(s) between two selected steps should be included.
* @public */ SelectedSteps: SelectedStep[] | undefined; } /** * @public */ export interface DescribePipelineExecutionResponse { /** *The Amazon Resource Name (ARN) of the pipeline.
* @public */ PipelineArn?: string | undefined; /** *The Amazon Resource Name (ARN) of the pipeline execution.
* @public */ PipelineExecutionArn?: string | undefined; /** *The display name of the pipeline execution.
* @public */ PipelineExecutionDisplayName?: string | undefined; /** *The status of the pipeline execution.
* @public */ PipelineExecutionStatus?: PipelineExecutionStatus | undefined; /** *The description of the pipeline execution.
* @public */ PipelineExecutionDescription?: string | undefined; /** *Specifies the names of the experiment and trial created by a pipeline.
* @public */ PipelineExperimentConfig?: PipelineExperimentConfig | undefined; /** *If the execution failed, a message describing why.
* @public */ FailureReason?: string | undefined; /** *The time when the pipeline execution was created.
* @public */ CreationTime?: Date | undefined; /** *The time when the pipeline execution was modified last.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy?: UserContext | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; /** *The parallelism configuration applied to the pipeline.
* @public */ ParallelismConfiguration?: ParallelismConfiguration | undefined; /** *The selective execution configuration applied to the pipeline run.
* @public */ SelectiveExecutionConfig?: SelectiveExecutionConfig | undefined; /** *The ID of the pipeline version.
* @public */ PipelineVersionId?: number | undefined; } /** * @public */ export interface DescribeProcessingJobRequest { /** *The name of the processing job. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ ProcessingJobName: string | undefined; } /** * @public * @enum */ export declare const ProcessingJobStatus: { readonly COMPLETED: "Completed"; readonly FAILED: "Failed"; readonly IN_PROGRESS: "InProgress"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; }; /** * @public */ export type ProcessingJobStatus = (typeof ProcessingJobStatus)[keyof typeof ProcessingJobStatus]; /** * @public */ export interface DescribeProcessingJobResponse { /** *The inputs for a processing job.
* @public */ ProcessingInputs?: ProcessingInput[] | undefined; /** *Output configuration for the processing job.
* @public */ ProcessingOutputConfig?: ProcessingOutputConfig | undefined; /** *The name of the processing job. The name must be unique within an Amazon Web Services Region in the Amazon Web Services account.
* @public */ ProcessingJobName: string | undefined; /** *Identifies the resources, ML compute instances, and ML storage volumes to deploy for a processing job. In distributed training, you specify more than one instance.
* @public */ ProcessingResources: ProcessingResources | undefined; /** *The time limit for how long the processing job is allowed to run.
* @public */ StoppingCondition?: ProcessingStoppingCondition | undefined; /** *Configures the processing job to run a specified container image.
* @public */ AppSpecification: AppSpecification | undefined; /** *The environment variables set in the Docker container.
* @public */ Environment?: RecordNetworking options for a processing job.
* @public */ NetworkConfig?: NetworkConfig | undefined; /** *The Amazon Resource Name (ARN) of an IAM role that Amazon SageMaker can assume to perform tasks on your behalf.
* @public */ RoleArn?: string | undefined; /** *The configuration information used to create an experiment.
* @public */ ExperimentConfig?: ExperimentConfig | undefined; /** *The Amazon Resource Name (ARN) of the processing job.
* @public */ ProcessingJobArn: string | undefined; /** *Provides the status of a processing job.
* @public */ ProcessingJobStatus: ProcessingJobStatus | undefined; /** *An optional string, up to one KB in size, that contains metadata from the processing container when the processing job exits.
* @public */ ExitMessage?: string | undefined; /** *A string, up to one KB in size, that contains the reason a processing job failed, if it failed.
* @public */ FailureReason?: string | undefined; /** *The time at which the processing job completed.
* @public */ ProcessingEndTime?: Date | undefined; /** *The time at which the processing job started.
* @public */ ProcessingStartTime?: Date | undefined; /** *The time at which the processing job was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *The time at which the processing job was created.
* @public */ CreationTime: Date | undefined; /** *The ARN of a monitoring schedule for an endpoint associated with this processing job.
* @public */ MonitoringScheduleArn?: string | undefined; /** *The ARN of an AutoML job associated with this processing job.
* @public */ AutoMLJobArn?: string | undefined; /** *The ARN of a training job associated with this processing job.
* @public */ TrainingJobArn?: string | undefined; } /** * @public */ export interface DescribeProjectInput { /** *The name of the project to describe.
* @public */ ProjectName: string | undefined; } /** * @public * @enum */ export declare const ProjectStatus: { readonly CREATE_COMPLETED: "CreateCompleted"; readonly CREATE_FAILED: "CreateFailed"; readonly CREATE_IN_PROGRESS: "CreateInProgress"; readonly DELETE_COMPLETED: "DeleteCompleted"; readonly DELETE_FAILED: "DeleteFailed"; readonly DELETE_IN_PROGRESS: "DeleteInProgress"; readonly PENDING: "Pending"; readonly UPDATE_COMPLETED: "UpdateCompleted"; readonly UPDATE_FAILED: "UpdateFailed"; readonly UPDATE_IN_PROGRESS: "UpdateInProgress"; }; /** * @public */ export type ProjectStatus = (typeof ProjectStatus)[keyof typeof ProjectStatus]; /** *Details of a provisioned service catalog product. For information about service catalog, see What is Amazon Web Services Service Catalog.
* @public */ export interface ServiceCatalogProvisionedProductDetails { /** *The ID of the provisioned product.
* @public */ ProvisionedProductId?: string | undefined; /** *The current status of the product.
AVAILABLE - Stable state, ready to perform any operation. The most recent operation succeeded and completed.
UNDER_CHANGE - Transitive state. Operations performed might not have valid results. Wait for an AVAILABLE status before performing operations.
TAINTED - Stable state, ready to perform any operation. The stack has completed the requested operation but is not exactly what was requested. For example, a request to update to a new version failed and the stack rolled back to the current version.
ERROR - An unexpected error occurred. The provisioned product exists but the stack is not running. For example, CloudFormation received a parameter value that was not valid and could not launch the stack.
PLAN_IN_PROGRESS - Transitive state. The plan operations were performed to provision a new product, but resources have not yet been created. After reviewing the list of resources to be created, execute the plan. Wait for an AVAILABLE status before performing operations.
Details about a template provider configuration and associated provisioning information.
* @public */ export interface TemplateProviderDetail { /** *Details about a CloudFormation template provider configuration and associated provisioning information.
* @public */ CfnTemplateProviderDetail?: CfnTemplateProviderDetail | undefined; } /** * @public */ export interface DescribeProjectOutput { /** *The Amazon Resource Name (ARN) of the project.
* @public */ ProjectArn: string | undefined; /** *The name of the project.
* @public */ ProjectName: string | undefined; /** *The ID of the project.
* @public */ ProjectId: string | undefined; /** *The description of the project.
* @public */ ProjectDescription?: string | undefined; /** *Information used to provision a service catalog product. For information, see What is Amazon Web Services Service Catalog.
* @public */ ServiceCatalogProvisioningDetails?: ServiceCatalogProvisioningDetails | undefined; /** *Information about a provisioned service catalog product.
* @public */ ServiceCatalogProvisionedProductDetails?: ServiceCatalogProvisionedProductDetails | undefined; /** *The status of the project.
* @public */ ProjectStatus: ProjectStatus | undefined; /** *An array of template providers associated with the project.
* @public */ TemplateProviderDetails?: TemplateProviderDetail[] | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ CreatedBy?: UserContext | undefined; /** *The time when the project was created.
* @public */ CreationTime: Date | undefined; /** *The timestamp when project was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; } /** * @public */ export interface DescribeReservedCapacityRequest { /** *ARN of the reserved capacity to describe.
* @public */ ReservedCapacityArn: string | undefined; } /** * @public * @enum */ export declare const ReservedCapacityInstanceType: { readonly ML_P4DE_24XLARGE: "ml.p4de.24xlarge"; readonly ML_P4D_24XLARGE: "ml.p4d.24xlarge"; readonly ML_P5EN_48XLARGE: "ml.p5en.48xlarge"; readonly ML_P5E_48XLARGE: "ml.p5e.48xlarge"; readonly ML_P5_48XLARGE: "ml.p5.48xlarge"; readonly ML_P6E_GB200_36XLARGE: "ml.p6e-gb200.36xlarge"; readonly ML_P6_B200_48XLARGE: "ml.p6-b200.48xlarge"; readonly ML_TRN1_32XLARGE: "ml.trn1.32xlarge"; readonly ML_TRN2_48XLARGE: "ml.trn2.48xlarge"; }; /** * @public */ export type ReservedCapacityInstanceType = (typeof ReservedCapacityInstanceType)[keyof typeof ReservedCapacityInstanceType]; /** * @public * @enum */ export declare const ReservedCapacityType: { readonly INSTANCE: "Instance"; readonly ULTRASERVER: "UltraServer"; }; /** * @public */ export type ReservedCapacityType = (typeof ReservedCapacityType)[keyof typeof ReservedCapacityType]; /** * @public * @enum */ export declare const ReservedCapacityStatus: { readonly ACTIVE: "Active"; readonly EXPIRED: "Expired"; readonly FAILED: "Failed"; readonly PENDING: "Pending"; readonly SCHEDULED: "Scheduled"; }; /** * @public */ export type ReservedCapacityStatus = (typeof ReservedCapacityStatus)[keyof typeof ReservedCapacityStatus]; /** *A summary of UltraServer resources and their current status.
* @public */ export interface UltraServerSummary { /** *The type of UltraServer, such as ml.u-p6e-gb200x72.
* @public */ UltraServerType: string | undefined; /** *The Amazon EC2 instance type used in the UltraServer.
* @public */ InstanceType: ReservedCapacityInstanceType | undefined; /** *The number of UltraServers of this type.
* @public */ UltraServerCount?: number | undefined; /** *The number of available spare instances in the UltraServers.
* @public */ AvailableSpareInstanceCount?: number | undefined; /** *The total number of instances across all UltraServers of this type that are currently in an unhealthy state.
* @public */ UnhealthyInstanceCount?: number | undefined; } /** * @public */ export interface DescribeReservedCapacityResponse { /** *ARN of the reserved capacity.
* @public */ ReservedCapacityArn: string | undefined; /** *The type of reserved capacity.
* @public */ ReservedCapacityType?: ReservedCapacityType | undefined; /** *The current status of the reserved capacity.
* @public */ Status?: ReservedCapacityStatus | undefined; /** *The Availability Zone where the reserved capacity is provisioned.
* @public */ AvailabilityZone?: string | undefined; /** *The total duration of the reserved capacity in hours.
* @public */ DurationHours?: number | undefined; /** *The number of minutes for the duration of the reserved capacity. For example, if a reserved capacity starts at 08:55 and ends at 11:30, the minutes field would be 35.
* @public */ DurationMinutes?: number | undefined; /** *The timestamp when the reserved capacity becomes active.
* @public */ StartTime?: Date | undefined; /** *The timestamp when the reserved capacity expires.
* @public */ EndTime?: Date | undefined; /** *The Amazon EC2 instance type used in the reserved capacity.
* @public */ InstanceType: ReservedCapacityInstanceType | undefined; /** *The total number of instances allocated to this reserved capacity.
* @public */ TotalInstanceCount: number | undefined; /** *The number of instances currently available for use in this reserved capacity.
* @public */ AvailableInstanceCount?: number | undefined; /** *The number of instances currently in use from this reserved capacity.
* @public */ InUseInstanceCount?: number | undefined; /** *A summary of the UltraServer associated with this reserved capacity.
* @public */ UltraServerSummary?: UltraServerSummary | undefined; } /** * @public */ export interface DescribeSpaceRequest { /** *The ID of the associated domain.
* @public */ DomainId: string | undefined; /** *The name of the space.
* @public */ SpaceName: string | undefined; } /** * @public * @enum */ export declare const SpaceStatus: { readonly Delete_Failed: "Delete_Failed"; readonly Deleting: "Deleting"; readonly Failed: "Failed"; readonly InService: "InService"; readonly Pending: "Pending"; readonly Update_Failed: "Update_Failed"; readonly Updating: "Updating"; }; /** * @public */ export type SpaceStatus = (typeof SpaceStatus)[keyof typeof SpaceStatus]; /** * @public */ export interface DescribeSpaceResponse { /** *The ID of the associated domain.
* @public */ DomainId?: string | undefined; /** *The space's Amazon Resource Name (ARN).
* @public */ SpaceArn?: string | undefined; /** *The name of the space.
* @public */ SpaceName?: string | undefined; /** *The ID of the space's profile in the Amazon EFS volume.
* @public */ HomeEfsFileSystemUid?: string | undefined; /** *The status.
* @public */ Status?: SpaceStatus | undefined; /** *The last modified time.
* @public */ LastModifiedTime?: Date | undefined; /** *The creation time.
* @public */ CreationTime?: Date | undefined; /** *The failure reason.
* @public */ FailureReason?: string | undefined; /** *A collection of space settings.
* @public */ SpaceSettings?: SpaceSettings | undefined; /** *The collection of ownership settings for a space.
* @public */ OwnershipSettings?: OwnershipSettings | undefined; /** *The collection of space sharing settings for a space.
* @public */ SpaceSharingSettings?: SpaceSharingSettings | undefined; /** *The name of the space that appears in the Amazon SageMaker Studio UI.
* @public */ SpaceDisplayName?: string | undefined; /** *Returns the URL of the space. If the space is created with Amazon Web Services IAM Identity Center (Successor to Amazon Web Services Single Sign-On) authentication, users can navigate to the URL after appending the respective redirect parameter for the application type to be federated through Amazon Web Services IAM Identity Center.
The following application types are supported:
Studio Classic: &redirect=JupyterServer
JupyterLab: &redirect=JupyterLab
Code Editor, based on Code-OSS, Visual Studio Code - Open Source: &redirect=CodeEditor
The name of the Amazon SageMaker AI Studio Lifecycle Configuration to describe.
* @public */ StudioLifecycleConfigName: string | undefined; } /** * @public */ export interface DescribeStudioLifecycleConfigResponse { /** *The ARN of the Lifecycle Configuration to describe.
* @public */ StudioLifecycleConfigArn?: string | undefined; /** *The name of the Amazon SageMaker AI Studio Lifecycle Configuration that is described.
* @public */ StudioLifecycleConfigName?: string | undefined; /** *The creation time of the Amazon SageMaker AI Studio Lifecycle Configuration.
* @public */ CreationTime?: Date | undefined; /** *This value is equivalent to CreationTime because Amazon SageMaker AI Studio Lifecycle Configurations are immutable.
* @public */ LastModifiedTime?: Date | undefined; /** *The content of your Amazon SageMaker AI Studio Lifecycle Configuration script.
* @public */ StudioLifecycleConfigContent?: string | undefined; /** *The App type that the Lifecycle Configuration is attached to.
* @public */ StudioLifecycleConfigAppType?: StudioLifecycleConfigAppType | undefined; } /** * @public */ export interface DescribeSubscribedWorkteamRequest { /** *The Amazon Resource Name (ARN) of the subscribed work team to describe.
* @public */ WorkteamArn: string | undefined; } /** *Describes a work team of a vendor that does the labelling job.
* @public */ export interface SubscribedWorkteam { /** *The Amazon Resource Name (ARN) of the vendor that you have subscribed.
* @public */ WorkteamArn: string | undefined; /** *The title of the service provided by the vendor in the Amazon Marketplace.
* @public */ MarketplaceTitle?: string | undefined; /** *The name of the vendor in the Amazon Marketplace.
* @public */ SellerName?: string | undefined; /** *The description of the vendor from the Amazon Marketplace.
* @public */ MarketplaceDescription?: string | undefined; /** *Marketplace product listing ID.
* @public */ ListingId?: string | undefined; } /** * @public */ export interface DescribeSubscribedWorkteamResponse { /** *A Workteam instance that contains information about the work team.
The name of the training job.
* @public */ TrainingJobName: string | undefined; } /** *The name, value, and date and time of a metric that was emitted to Amazon CloudWatch.
* @public */ export interface MetricData { /** *The name of the metric.
* @public */ MetricName?: string | undefined; /** *The value of the metric.
* @public */ Value?: number | undefined; /** *The date and time that the algorithm emitted the metric.
* @public */ Timestamp?: Date | undefined; } /** *Information about the status of the rule evaluation.
* @public */ export interface ProfilerRuleEvaluationStatus { /** *The name of the rule configuration.
* @public */ RuleConfigurationName?: string | undefined; /** *The Amazon Resource Name (ARN) of the rule evaluation job.
* @public */ RuleEvaluationJobArn?: string | undefined; /** *Status of the rule evaluation.
* @public */ RuleEvaluationStatus?: RuleEvaluationStatus | undefined; /** *Details from the rule evaluation.
* @public */ StatusDetails?: string | undefined; /** *Timestamp when the rule evaluation status was last modified.
* @public */ LastModifiedTime?: Date | undefined; } /** * @public * @enum */ export declare const ProfilingStatus: { readonly DISABLED: "Disabled"; readonly ENABLED: "Enabled"; }; /** * @public */ export type ProfilingStatus = (typeof ProfilingStatus)[keyof typeof ProfilingStatus]; /** * @public * @enum */ export declare const SecondaryStatus: { readonly COMPLETED: "Completed"; readonly DOWNLOADING: "Downloading"; readonly DOWNLOADING_TRAINING_IMAGE: "DownloadingTrainingImage"; readonly FAILED: "Failed"; readonly INTERRUPTED: "Interrupted"; readonly LAUNCHING_ML_INSTANCES: "LaunchingMLInstances"; readonly MAX_RUNTIME_EXCEEDED: "MaxRuntimeExceeded"; readonly MAX_WAIT_TIME_EXCEEDED: "MaxWaitTimeExceeded"; readonly PENDING: "Pending"; readonly PREPARING_TRAINING_STACK: "PreparingTrainingStack"; readonly RESTARTING: "Restarting"; readonly STARTING: "Starting"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; readonly TRAINING: "Training"; readonly UPDATING: "Updating"; readonly UPLOADING: "Uploading"; }; /** * @public */ export type SecondaryStatus = (typeof SecondaryStatus)[keyof typeof SecondaryStatus]; /** *An array element of SecondaryStatusTransitions for DescribeTrainingJob. It provides additional details about a status that the training job has transitioned through. A training job can be in one of several states, for example, starting, downloading, training, or uploading. Within each state, there are a number of intermediate states. For example, within the starting state, SageMaker could be starting the training job or launching the ML instances. These transitional states are referred to as the job's secondary status.
Contains a secondary status information from a training job.
Status might be one of the following secondary statuses:
Starting - Starting the training job.
Downloading - An optional stage for algorithms that support File training input mode. It indicates that data is being downloaded to the ML storage volumes.
Training - Training is in progress.
Uploading - Training is complete and the model artifacts are being uploaded to the S3 location.
Completed - The training job has completed.
Failed - The training job has failed. The reason for the failure is returned in the FailureReason field of DescribeTrainingJobResponse.
MaxRuntimeExceeded - The job stopped because it exceeded the maximum allowed runtime.
Stopped - The training job has stopped.
Stopping - Stopping the training job.
We no longer support the following secondary statuses:
LaunchingMLInstances
PreparingTrainingStack
DownloadingTrainingImage
A timestamp that shows when the training job transitioned to the current secondary status state.
* @public */ StartTime: Date | undefined; /** *A timestamp that shows when the training job transitioned out of this secondary status state into another secondary status state or when the training job has ended.
* @public */ EndTime?: Date | undefined; /** *A detailed description of the progress within a secondary status.
SageMaker provides secondary statuses and status messages that apply to each of them:
Starting the training job.
Launching requested ML instances.
Insufficient capacity error from EC2 while launching instances, retrying!
Launched instance was unhealthy, replacing it!
Preparing the instances for training.
Training image download completed. Training in progress.
Status messages are subject to change. Therefore, we recommend not including them in code that programmatically initiates actions. For examples, don't use status messages in if statements.
To have an overview of your training job's progress, view TrainingJobStatus and SecondaryStatus in DescribeTrainingJob, and StatusMessage together. For example, at the start of a training job, you might see the following:
TrainingJobStatus - InProgress
SecondaryStatus - Training
StatusMessage - Downloading the training image
Status and billing information about the warm pool.
* @public */ export interface WarmPoolStatus { /** *The status of the warm pool.
InUse: The warm pool is in use for the training job.
Available: The warm pool is available to reuse for a matching training job.
Reused: The warm pool moved to a matching training job for reuse.
Terminated: The warm pool is no longer available. Warm pools are unavailable if they are terminated by a user, terminated for a patch update, or terminated for exceeding the specified KeepAlivePeriodInSeconds.
The billable time in seconds used by the warm pool. Billable time refers to the absolute wall-clock time.
Multiply ResourceRetainedBillableTimeInSeconds by the number of instances (InstanceCount) in your training cluster to get the total compute time SageMaker bills you if you run warm pool training. The formula is as follows: ResourceRetainedBillableTimeInSeconds * InstanceCount.
The name of the matching training job that reused the warm pool.
* @public */ ReusedByJob?: string | undefined; } /** * @public */ export interface DescribeTrainingJobResponse { /** *Name of the model training job.
* @public */ TrainingJobName: string | undefined; /** *The Amazon Resource Name (ARN) of the training job.
* @public */ TrainingJobArn: string | undefined; /** *The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the training job was launched by a hyperparameter tuning job.
* @public */ TuningJobArn?: string | undefined; /** *The Amazon Resource Name (ARN) of the SageMaker Ground Truth labeling job that created the transform or training job.
* @public */ LabelingJobArn?: string | undefined; /** *The Amazon Resource Name (ARN) of an AutoML job.
* @public */ AutoMLJobArn?: string | undefined; /** *Information about the Amazon S3 location that is configured for storing model artifacts.
* @public */ ModelArtifacts: ModelArtifacts | undefined; /** *The status of the training job.
SageMaker provides the following training job statuses:
InProgress - The training is in progress.
Completed - The training job has completed.
Failed - The training job has failed. To see the reason for the failure, see the FailureReason field in the response to a DescribeTrainingJobResponse call.
Stopping - The training job is stopping.
Stopped - The training job has stopped.
For more detailed information, see SecondaryStatus.
Provides detailed information about the state of the training job. For detailed information on the secondary status of the training job, see StatusMessage under SecondaryStatusTransition.
SageMaker provides primary statuses and secondary statuses that apply to each of them:
Starting - Starting the training job.
Downloading - An optional stage for algorithms that support File training input mode. It indicates that data is being downloaded to the ML storage volumes.
Training - Training is in progress.
Interrupted - The job stopped because the managed spot training instances were interrupted.
Uploading - Training is complete and the model artifacts are being uploaded to the S3 location.
Completed - The training job has completed.
Failed - The training job has failed. The reason for the failure is returned in the FailureReason field of DescribeTrainingJobResponse.
MaxRuntimeExceeded - The job stopped because it exceeded the maximum allowed runtime.
MaxWaitTimeExceeded - The job stopped because it exceeded the maximum allowed wait time.
Stopped - The training job has stopped.
Stopping - Stopping the training job.
Valid values for SecondaryStatus are subject to change.
We no longer support the following secondary statuses:
LaunchingMLInstances
PreparingTraining
DownloadingTrainingImage
If the training job failed, the reason it failed.
* @public */ FailureReason?: string | undefined; /** *Algorithm-specific parameters.
* @public */ HyperParameters?: RecordInformation about the algorithm used for training, and algorithm metadata.
* @public */ AlgorithmSpecification: AlgorithmSpecification | undefined; /** *The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.
* @public */ RoleArn?: string | undefined; /** *An array of Channel objects that describes each data input channel.
The S3 path where model artifacts that you configured when creating the job are stored. SageMaker creates subfolders for model artifacts.
* @public */ OutputDataConfig?: OutputDataConfig | undefined; /** *Resources, including ML compute instances and ML storage volumes, that are configured for model training.
* @public */ ResourceConfig: ResourceConfig | undefined; /** *The status of the warm pool associated with the training job.
* @public */ WarmPoolStatus?: WarmPoolStatus | undefined; /** *A VpcConfig object that specifies the VPC that this training job has access to. For more information, see Protect Training Jobs by Using an Amazon Virtual Private Cloud.
* @public */ VpcConfig?: VpcConfig | undefined; /** *Specifies a limit to how long a model training job can run. It also specifies how long a managed Spot training job has to complete. When the job reaches the time limit, SageMaker ends the training job. Use this API to cap model training costs.
To stop a job, SageMaker sends the algorithm the SIGTERM signal, which delays job termination for 120 seconds. Algorithms can use this 120-second window to save the model artifacts, so the results of training are not lost.
A timestamp that indicates when the training job was created.
* @public */ CreationTime: Date | undefined; /** *Indicates the time when the training job starts on training instances. You are billed for the time interval between this time and the value of TrainingEndTime. The start time in CloudWatch Logs might be later than this time. The difference is due to the time it takes to download the training data and to the size of the training container.
Indicates the time when the training job ends on training instances. You are billed for the time interval between the value of TrainingStartTime and this time. For successful jobs and stopped jobs, this is the time after model artifacts are uploaded. For failed jobs, this is the time when SageMaker detects a job failure.
A timestamp that indicates when the status of the training job was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *A history of all of the secondary statuses that the training job has transitioned through.
* @public */ SecondaryStatusTransitions?: SecondaryStatusTransition[] | undefined; /** *A collection of MetricData objects that specify the names, values, and dates and times that the training algorithm emitted to Amazon CloudWatch.
If you want to allow inbound or outbound network calls, except for calls between peers within a training cluster for distributed training, choose True. If you enable network isolation for training jobs that are configured to use a VPC, SageMaker downloads and uploads customer data and model artifacts through the specified VPC, but the training container does not have network access.
To encrypt all communications between ML compute instances in distributed training, choose True. Encryption provides greater security for distributed training, but training might take longer. How long it takes depends on the amount of communication between compute instances, especially if you use a deep learning algorithms in distributed training.
A Boolean indicating whether managed spot training is enabled (True) or not (False).
Contains information about the output location for managed spot training checkpoint data.
* @public */ CheckpointConfig?: CheckpointConfig | undefined; /** *The training time in seconds.
* @public */ TrainingTimeInSeconds?: number | undefined; /** *The billable time in seconds. Billable time refers to the absolute wall-clock time.
Multiply BillableTimeInSeconds by the number of instances (InstanceCount) in your training cluster to get the total compute time SageMaker bills you if you run distributed training. The formula is as follows: BillableTimeInSeconds * InstanceCount .
You can calculate the savings from using managed spot training using the formula (1 - BillableTimeInSeconds / TrainingTimeInSeconds) * 100. For example, if BillableTimeInSeconds is 100 and TrainingTimeInSeconds is 500, the savings is 80%.
Configuration information for the Amazon SageMaker Debugger hook parameters, metric and tensor collections, and storage paths. To learn more about how to configure the DebugHookConfig parameter, see Use the SageMaker and Debugger Configuration API Operations to Create, Update, and Debug Your Training Job.
Associates a SageMaker job as a trial component with an experiment and trial. Specified when you call the following APIs:
* @public */ ExperimentConfig?: ExperimentConfig | undefined; /** *Configuration information for Amazon SageMaker Debugger rules for debugging output tensors.
* @public */ DebugRuleConfigurations?: DebugRuleConfiguration[] | undefined; /** *Configuration of storage locations for the Amazon SageMaker Debugger TensorBoard output data.
* @public */ TensorBoardOutputConfig?: TensorBoardOutputConfig | undefined; /** *Evaluation status of Amazon SageMaker Debugger rules for debugging on a training job.
* @public */ DebugRuleEvaluationStatuses?: DebugRuleEvaluationStatus[] | undefined; /** *Configuration information for Amazon SageMaker Debugger system monitoring, framework profiling, and storage paths.
* @public */ ProfilerConfig?: ProfilerConfig | undefined; /** *Configuration information for Amazon SageMaker Debugger rules for profiling system and framework metrics.
* @public */ ProfilerRuleConfigurations?: ProfilerRuleConfiguration[] | undefined; /** *Evaluation status of Amazon SageMaker Debugger rules for profiling on a training job.
* @public */ ProfilerRuleEvaluationStatuses?: ProfilerRuleEvaluationStatus[] | undefined; /** *Profiling status of a training job.
* @public */ ProfilingStatus?: ProfilingStatus | undefined; /** *The environment variables to set in the Docker container.
Do not include any security-sensitive information including account access IDs, secrets, or tokens in any environment fields. As part of the shared responsibility model, you are responsible for any potential exposure, unauthorized access, or compromise of your sensitive data if caused by security-sensitive information included in the request environment variable or plain text fields.
The number of times to retry the job when the job fails due to an InternalServerError.
Configuration for remote debugging. To learn more about the remote debugging functionality of SageMaker, see Access a training container through Amazon Web Services Systems Manager (SSM) for remote debugging.
* @public */ RemoteDebugConfig?: RemoteDebugConfig | undefined; /** *Contains information about the infrastructure health check configuration for the training job.
* @public */ InfraCheckConfig?: InfraCheckConfig | undefined; } /** * @public */ export interface DescribeTrainingPlanRequest { /** *The name of the training plan to describe.
* @public */ TrainingPlanName: string | undefined; } /** *Details of a reserved capacity for the training plan.
For more information about how to reserve GPU capacity for your SageMaker HyperPod clusters using Amazon SageMaker Training Plan, see CreateTrainingPlan .
The Amazon Resource Name (ARN); of the reserved capacity.
* @public */ ReservedCapacityArn: string | undefined; /** *The type of reserved capacity.
* @public */ ReservedCapacityType?: ReservedCapacityType | undefined; /** *The type of UltraServer included in this reserved capacity, such as ml.u-p6e-gb200x72.
* @public */ UltraServerType?: string | undefined; /** *The number of UltraServers included in this reserved capacity.
* @public */ UltraServerCount?: number | undefined; /** *The instance type for the reserved capacity.
* @public */ InstanceType: ReservedCapacityInstanceType | undefined; /** *The total number of instances in the reserved capacity.
* @public */ TotalInstanceCount: number | undefined; /** *The current status of the reserved capacity.
* @public */ Status: ReservedCapacityStatus | undefined; /** *The availability zone for the reserved capacity.
* @public */ AvailabilityZone?: string | undefined; /** *The number of whole hours in the total duration for this reserved capacity.
* @public */ DurationHours?: number | undefined; /** *The additional minutes beyond whole hours in the total duration for this reserved capacity.
* @public */ DurationMinutes?: number | undefined; /** *The start time of the reserved capacity.
* @public */ StartTime?: Date | undefined; /** *The end time of the reserved capacity.
* @public */ EndTime?: Date | undefined; } /** * @public * @enum */ export declare const TrainingPlanStatus: { readonly ACTIVE: "Active"; readonly EXPIRED: "Expired"; readonly FAILED: "Failed"; readonly PENDING: "Pending"; readonly SCHEDULED: "Scheduled"; }; /** * @public */ export type TrainingPlanStatus = (typeof TrainingPlanStatus)[keyof typeof TrainingPlanStatus]; /** * @public * @enum */ export declare const SageMakerResourceName: { readonly HYPERPOD_CLUSTER: "hyperpod-cluster"; readonly TRAINING_JOB: "training-job"; }; /** * @public */ export type SageMakerResourceName = (typeof SageMakerResourceName)[keyof typeof SageMakerResourceName]; /** * @public */ export interface DescribeTrainingPlanResponse { /** *The Amazon Resource Name (ARN); of the training plan.
* @public */ TrainingPlanArn: string | undefined; /** *The name of the training plan.
* @public */ TrainingPlanName: string | undefined; /** *The current status of the training plan (e.g., Pending, Active, Expired). To see the complete list of status values available for a training plan, refer to the Status attribute within the TrainingPlanSummary object.
A message providing additional information about the current status of the training plan.
* @public */ StatusMessage?: string | undefined; /** *The number of whole hours in the total duration for this training plan.
* @public */ DurationHours?: number | undefined; /** *The additional minutes beyond whole hours in the total duration for this training plan.
* @public */ DurationMinutes?: number | undefined; /** *The start time of the training plan.
* @public */ StartTime?: Date | undefined; /** *The end time of the training plan.
* @public */ EndTime?: Date | undefined; /** *The upfront fee for the training plan.
* @public */ UpfrontFee?: string | undefined; /** *The currency code for the upfront fee (e.g., USD).
* @public */ CurrencyCode?: string | undefined; /** *The total number of instances reserved in this training plan.
* @public */ TotalInstanceCount?: number | undefined; /** *The number of instances currently available for use in this training plan.
* @public */ AvailableInstanceCount?: number | undefined; /** *The number of instances currently in use from this training plan.
* @public */ InUseInstanceCount?: number | undefined; /** *The number of instances in the training plan that are currently in an unhealthy state.
* @public */ UnhealthyInstanceCount?: number | undefined; /** *The number of available spare instances in the training plan.
* @public */ AvailableSpareInstanceCount?: number | undefined; /** *The total number of UltraServers reserved to this training plan.
* @public */ TotalUltraServerCount?: number | undefined; /** *The target resources (e.g., SageMaker Training Jobs, SageMaker HyperPod) that can use this training plan.
Training plans are specific to their target resource.
A training plan designed for SageMaker training jobs can only be used to schedule and run training jobs.
A training plan for HyperPod clusters can be used exclusively to provide compute resources to a cluster's instance group.
The list of Reserved Capacity providing the underlying compute resources of the plan.
* @public */ ReservedCapacitySummaries?: ReservedCapacitySummary[] | undefined; } /** * @public */ export interface DescribeTransformJobRequest { /** *The name of the transform job that you want to view details of.
* @public */ TransformJobName: string | undefined; } /** * @public * @enum */ export declare const TransformJobStatus: { readonly COMPLETED: "Completed"; readonly FAILED: "Failed"; readonly IN_PROGRESS: "InProgress"; readonly STOPPED: "Stopped"; readonly STOPPING: "Stopping"; }; /** * @public */ export type TransformJobStatus = (typeof TransformJobStatus)[keyof typeof TransformJobStatus]; /** * @public */ export interface DescribeTransformJobResponse { /** *The name of the transform job.
* @public */ TransformJobName: string | undefined; /** *The Amazon Resource Name (ARN) of the transform job.
* @public */ TransformJobArn: string | undefined; /** *The status of the transform job. If the transform job failed, the reason is returned in the FailureReason field.
If the transform job failed, FailureReason describes why it failed. A transform job creates a log file, which includes error messages, and stores it as an Amazon S3 object. For more information, see Log Amazon SageMaker Events with Amazon CloudWatch.
The name of the model used in the transform job.
* @public */ ModelName: string | undefined; /** *The maximum number of parallel requests on each instance node that can be launched in a transform job. The default value is 1.
* @public */ MaxConcurrentTransforms?: number | undefined; /** *The timeout and maximum number of retries for processing a transform job invocation.
* @public */ ModelClientConfig?: ModelClientConfig | undefined; /** *The maximum payload size, in MB, used in the transform job.
* @public */ MaxPayloadInMB?: number | undefined; /** *Specifies the number of records to include in a mini-batch for an HTTP inference request. A record is a single unit of input data that inference can be made on. For example, a single line in a CSV file is a record.
To enable the batch strategy, you must set SplitType to Line, RecordIO, or TFRecord.
The environment variables to set in the Docker container. We support up to 16 key and values entries in the map.
* @public */ Environment?: RecordDescribes the dataset to be transformed and the Amazon S3 location where it is stored.
* @public */ TransformInput: TransformInput | undefined; /** *Identifies the Amazon S3 location where you want Amazon SageMaker to save the results from the transform job.
* @public */ TransformOutput?: TransformOutput | undefined; /** *Configuration to control how SageMaker captures inference data.
* @public */ DataCaptureConfig?: BatchDataCaptureConfig | undefined; /** *Describes the resources, including ML instance types and ML instance count, to use for the transform job.
* @public */ TransformResources: TransformResources | undefined; /** *A timestamp that shows when the transform Job was created.
* @public */ CreationTime: Date | undefined; /** *Indicates when the transform job starts on ML instances. You are billed for the time interval between this time and the value of TransformEndTime.
Indicates when the transform job has been completed, or has stopped or failed. You are billed for the time interval between this time and the value of TransformStartTime.
The Amazon Resource Name (ARN) of the Amazon SageMaker Ground Truth labeling job that created the transform or training job.
* @public */ LabelingJobArn?: string | undefined; /** *The Amazon Resource Name (ARN) of the AutoML transform job.
* @public */ AutoMLJobArn?: string | undefined; /** *The data structure used to specify the data to be used for inference in a batch transform job and to associate the data that is relevant to the prediction results in the output. The input filter provided allows you to exclude input data that is not needed for inference in a batch transform job. The output filter provided allows you to include input data relevant to interpreting the predictions in the output from the job. For more information, see Associate Prediction Results with their Corresponding Input Records.
* @public */ DataProcessing?: DataProcessing | undefined; /** *Associates a SageMaker job as a trial component with an experiment and trial. Specified when you call the following APIs:
* @public */ ExperimentConfig?: ExperimentConfig | undefined; } /** * @public */ export interface DescribeTrialRequest { /** *The name of the trial to describe.
* @public */ TrialName: string | undefined; } /** *The source of the trial.
* @public */ export interface TrialSource { /** *The Amazon Resource Name (ARN) of the source.
* @public */ SourceArn: string | undefined; /** *The source job type.
* @public */ SourceType?: string | undefined; } /** * @public */ export interface DescribeTrialResponse { /** *The name of the trial.
* @public */ TrialName?: string | undefined; /** *The Amazon Resource Name (ARN) of the trial.
* @public */ TrialArn?: string | undefined; /** *The name of the trial as displayed. If DisplayName isn't specified, TrialName is displayed.
The name of the experiment the trial is part of.
* @public */ ExperimentName?: string | undefined; /** *The Amazon Resource Name (ARN) of the source and, optionally, the job type.
* @public */ Source?: TrialSource | undefined; /** *When the trial was created.
* @public */ CreationTime?: Date | undefined; /** *Who created the trial.
* @public */ CreatedBy?: UserContext | undefined; /** *When the trial was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Who last modified the trial.
* @public */ LastModifiedBy?: UserContext | undefined; /** *Metadata properties of the tracking entity, trial, or trial component.
* @public */ MetadataProperties?: MetadataProperties | undefined; } /** * @public */ export interface DescribeTrialComponentRequest { /** *The name of the trial component to describe.
* @public */ TrialComponentName: string | undefined; } /** *A summary of the metrics of a trial component.
* @public */ export interface TrialComponentMetricSummary { /** *The name of the metric.
* @public */ MetricName?: string | undefined; /** *The Amazon Resource Name (ARN) of the source.
* @public */ SourceArn?: string | undefined; /** *When the metric was last updated.
* @public */ TimeStamp?: Date | undefined; /** *The maximum value of the metric.
* @public */ Max?: number | undefined; /** *The minimum value of the metric.
* @public */ Min?: number | undefined; /** *The most recent value of the metric.
* @public */ Last?: number | undefined; /** *The number of samples used to generate the metric.
* @public */ Count?: number | undefined; /** *The average value of the metric.
* @public */ Avg?: number | undefined; /** *The standard deviation of the metric.
* @public */ StdDev?: number | undefined; } /** *The Amazon Resource Name (ARN) and job type of the source of a trial component.
* @public */ export interface TrialComponentSource { /** *The source Amazon Resource Name (ARN).
* @public */ SourceArn: string | undefined; /** *The source job type.
* @public */ SourceType?: string | undefined; } /** * @public */ export interface DescribeTrialComponentResponse { /** *The name of the trial component.
* @public */ TrialComponentName?: string | undefined; /** *The Amazon Resource Name (ARN) of the trial component.
* @public */ TrialComponentArn?: string | undefined; /** *The name of the component as displayed. If DisplayName isn't specified, TrialComponentName is displayed.
The Amazon Resource Name (ARN) of the source and, optionally, the job type.
* @public */ Source?: TrialComponentSource | undefined; /** *The status of the component. States include:
InProgress
Completed
Failed
When the component started.
* @public */ StartTime?: Date | undefined; /** *When the component ended.
* @public */ EndTime?: Date | undefined; /** *When the component was created.
* @public */ CreationTime?: Date | undefined; /** *Who created the trial component.
* @public */ CreatedBy?: UserContext | undefined; /** *When the component was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Who last modified the component.
* @public */ LastModifiedBy?: UserContext | undefined; /** *The hyperparameters of the component.
* @public */ Parameters?: RecordThe input artifacts of the component.
* @public */ InputArtifacts?: RecordThe output artifacts of the component.
* @public */ OutputArtifacts?: RecordMetadata properties of the tracking entity, trial, or trial component.
* @public */ MetadataProperties?: MetadataProperties | undefined; /** *The metrics for the component.
* @public */ Metrics?: TrialComponentMetricSummary[] | undefined; /** *The Amazon Resource Name (ARN) of the lineage group.
* @public */ LineageGroupArn?: string | undefined; /** *A list of ARNs and, if applicable, job types for multiple sources of an experiment run.
* @public */ Sources?: TrialComponentSource[] | undefined; } /** * @public */ export interface DescribeUserProfileRequest { /** *The domain ID.
* @public */ DomainId: string | undefined; /** *The user profile name. This value is not case sensitive.
* @public */ UserProfileName: string | undefined; } /** * @public * @enum */ export declare const UserProfileStatus: { readonly Delete_Failed: "Delete_Failed"; readonly Deleting: "Deleting"; readonly Failed: "Failed"; readonly InService: "InService"; readonly Pending: "Pending"; readonly Update_Failed: "Update_Failed"; readonly Updating: "Updating"; }; /** * @public */ export type UserProfileStatus = (typeof UserProfileStatus)[keyof typeof UserProfileStatus]; /** * @public */ export interface DescribeUserProfileResponse { /** *The ID of the domain that contains the profile.
* @public */ DomainId?: string | undefined; /** *The user profile Amazon Resource Name (ARN).
* @public */ UserProfileArn?: string | undefined; /** *The user profile name.
* @public */ UserProfileName?: string | undefined; /** *The ID of the user's profile in the Amazon Elastic File System volume.
* @public */ HomeEfsFileSystemUid?: string | undefined; /** *The status.
* @public */ Status?: UserProfileStatus | undefined; /** *The last modified time.
* @public */ LastModifiedTime?: Date | undefined; /** *The creation time.
* @public */ CreationTime?: Date | undefined; /** *The failure reason.
* @public */ FailureReason?: string | undefined; /** *The IAM Identity Center user identifier.
* @public */ SingleSignOnUserIdentifier?: string | undefined; /** *The IAM Identity Center user value.
* @public */ SingleSignOnUserValue?: string | undefined; /** *A collection of settings.
* @public */ UserSettings?: UserSettings | undefined; } /** * @public */ export interface DescribeWorkforceRequest { /** *The name of the private workforce whose access you want to restrict. WorkforceName is automatically set to default when a workforce is created and cannot be modified.
Your OIDC IdP workforce configuration.
* @public */ export interface OidcConfigForResponse { /** *The OIDC IdP client ID used to configure your private workforce.
* @public */ ClientId?: string | undefined; /** *The OIDC IdP issuer used to configure your private workforce.
* @public */ Issuer?: string | undefined; /** *The OIDC IdP authorization endpoint used to configure your private workforce.
* @public */ AuthorizationEndpoint?: string | undefined; /** *The OIDC IdP token endpoint used to configure your private workforce.
* @public */ TokenEndpoint?: string | undefined; /** *The OIDC IdP user information endpoint used to configure your private workforce.
* @public */ UserInfoEndpoint?: string | undefined; /** *The OIDC IdP logout endpoint used to configure your private workforce.
* @public */ LogoutEndpoint?: string | undefined; /** *The OIDC IdP JSON Web Key Set (Jwks) URI used to configure your private workforce.
* @public */ JwksUri?: string | undefined; /** *An array of string identifiers used to refer to the specific pieces of user data or claims that the client application wants to access.
* @public */ Scope?: string | undefined; /** *A string to string map of identifiers specific to the custom identity provider (IdP) being used.
* @public */ AuthenticationRequestExtraParams?: RecordA VpcConfig object that specifies the VPC that you want your workforce to connect to.
* @public */ export interface WorkforceVpcConfigResponse { /** *The ID of the VPC that the workforce uses for communication.
* @public */ VpcId: string | undefined; /** *The VPC security group IDs, in the form sg-xxxxxxxx. The security groups must be for the same VPC as specified in the subnet.
* @public */ SecurityGroupIds: string[] | undefined; /** *The ID of the subnets in the VPC that you want to connect.
* @public */ Subnets: string[] | undefined; /** *The IDs for the VPC service endpoints of your VPC workforce when it is created and updated.
* @public */ VpcEndpointId?: string | undefined; } /** *A single private workforce, which is automatically created when you create your first private work team. You can create one private work force in each Amazon Web Services Region. By default, any workforce-related API operation used in a specific region will apply to the workforce created in that region. To learn how to create a private workforce, see Create a Private Workforce.
* @public */ export interface Workforce { /** *The name of the private workforce.
* @public */ WorkforceName: string | undefined; /** *The Amazon Resource Name (ARN) of the private workforce.
* @public */ WorkforceArn: string | undefined; /** *The most recent date that UpdateWorkforce was used to successfully add one or more IP address ranges (CIDRs) to a private workforce's allow list.
* @public */ LastUpdatedDate?: Date | undefined; /** *A list of one to ten IP address ranges (CIDRs) to be added to the workforce allow list. By default, a workforce isn't restricted to specific IP addresses.
* @public */ SourceIpConfig?: SourceIpConfig | undefined; /** *The subdomain for your OIDC Identity Provider.
* @public */ SubDomain?: string | undefined; /** *The configuration of an Amazon Cognito workforce. A single Cognito workforce is created using and corresponds to a single Amazon Cognito user pool.
* @public */ CognitoConfig?: CognitoConfig | undefined; /** *The configuration of an OIDC Identity Provider (IdP) private workforce.
* @public */ OidcConfig?: OidcConfigForResponse | undefined; /** *The date that the workforce is created.
* @public */ CreateDate?: Date | undefined; /** *The configuration of a VPC workforce.
* @public */ WorkforceVpcConfig?: WorkforceVpcConfigResponse | undefined; /** *The status of your workforce.
* @public */ Status?: WorkforceStatus | undefined; /** *The reason your workforce failed.
* @public */ FailureReason?: string | undefined; /** *The IP address type you specify - either IPv4 only or dualstack (IPv4 and IPv6) - to support your labeling workforce.
A single private workforce, which is automatically created when you create your first private work team. You can create one private work force in each Amazon Web Services Region. By default, any workforce-related API operation used in a specific region will apply to the workforce created in that region. To learn how to create a private workforce, see Create a Private Workforce.
* @public */ Workforce: Workforce | undefined; } /** * @public */ export interface DescribeWorkteamRequest { /** *The name of the work team to return a description of.
* @public */ WorkteamName: string | undefined; } /** *Provides details about a labeling work team.
* @public */ export interface Workteam { /** *The name of the work team.
* @public */ WorkteamName: string | undefined; /** *A list of MemberDefinition objects that contains objects that identify the workers that make up the work team.
Workforces can be created using Amazon Cognito or your own OIDC Identity Provider (IdP). For private workforces created using Amazon Cognito use CognitoMemberDefinition. For workforces created using your own OIDC identity provider (IdP) use OidcMemberDefinition.
The Amazon Resource Name (ARN) that identifies the work team.
* @public */ WorkteamArn: string | undefined; /** *The Amazon Resource Name (ARN) of the workforce.
* @public */ WorkforceArn?: string | undefined; /** *The Amazon Marketplace identifier for a vendor's work team.
* @public */ ProductListingIds?: string[] | undefined; /** *A description of the work team.
* @public */ Description: string | undefined; /** *The URI of the labeling job's user interface. Workers open this URI to start labeling your data objects.
* @public */ SubDomain?: string | undefined; /** *The date and time that the work team was created (timestamp).
* @public */ CreateDate?: Date | undefined; /** *The date and time that the work team was last updated (timestamp).
* @public */ LastUpdatedDate?: Date | undefined; /** *Configures SNS notifications of available or expiring work items for work teams.
* @public */ NotificationConfiguration?: NotificationConfiguration | undefined; /** *Describes any access constraints that have been defined for Amazon S3 resources.
* @public */ WorkerAccessConfiguration?: WorkerAccessConfiguration | undefined; } /** * @public */ export interface DescribeWorkteamResponse { /** *A Workteam instance that contains information about the work team.
Specifies the serverless update concurrency configuration for an endpoint variant.
* @public */ export interface ProductionVariantServerlessUpdateConfig { /** *The updated maximum number of concurrent invocations your serverless endpoint can process.
* @public */ MaxConcurrency?: number | undefined; /** *The updated amount of provisioned concurrency to allocate for the serverless endpoint. Should be less than or equal to MaxConcurrency.
Specifies weight and capacity values for a production variant.
* @public */ export interface DesiredWeightAndCapacity { /** *The name of the variant to update.
* @public */ VariantName: string | undefined; /** *The variant's weight.
* @public */ DesiredWeight?: number | undefined; /** *The variant's capacity.
* @public */ DesiredInstanceCount?: number | undefined; /** *Specifies the serverless update concurrency configuration for an endpoint variant.
* @public */ ServerlessUpdateConfig?: ProductionVariantServerlessUpdateConfig | undefined; } /** * @public */ export interface DetachClusterNodeVolumeRequest { /** * The Amazon Resource Name (ARN) of your SageMaker HyperPod cluster containing the target node. Your cluster must use EKS as the orchestration and be in the InService state.
The unique identifier of the cluster node from which you want to detach the volume.
* @public */ NodeId: string | undefined; /** *The unique identifier of your EBS volume that you want to detach. Your volume must be currently attached to the specified node.
* @public */ VolumeId: string | undefined; } /** * @public */ export interface DetachClusterNodeVolumeResponse { /** *The Amazon Resource Name (ARN) of your SageMaker HyperPod cluster where the volume detachment operation was performed.
* @public */ ClusterArn: string | undefined; /** *The unique identifier of the cluster node from which your volume was detached.
* @public */ NodeId: string | undefined; /** *The unique identifier of your EBS volume that was detached.
* @public */ VolumeId: string | undefined; /** *The original timestamp when your volume was initially attached to the node.
* @public */ AttachTime: Date | undefined; /** *The current status of your volume detachment operation.
* @public */ Status: VolumeAttachmentStatus | undefined; /** *The device name assigned to your attached volume on the target instance.
* @public */ DeviceName: string | undefined; } /** *Information of a particular device.
* @public */ export interface Device { /** *The name of the device.
* @public */ DeviceName: string | undefined; /** *Description of the device.
* @public */ Description?: string | undefined; /** *Amazon Web Services Internet of Things (IoT) object name.
* @public */ IotThingName?: string | undefined; } /** * @public * @enum */ export declare const DeviceDeploymentStatus: { readonly Deployed: "DEPLOYED"; readonly Failed: "FAILED"; readonly InProgress: "INPROGRESS"; readonly ReadyToDeploy: "READYTODEPLOY"; readonly Stopped: "STOPPED"; readonly Stopping: "STOPPING"; }; /** * @public */ export type DeviceDeploymentStatus = (typeof DeviceDeploymentStatus)[keyof typeof DeviceDeploymentStatus]; /** *Contains information summarizing device details and deployment status.
* @public */ export interface DeviceDeploymentSummary { /** *The ARN of the edge deployment plan.
* @public */ EdgeDeploymentPlanArn: string | undefined; /** *The name of the edge deployment plan.
* @public */ EdgeDeploymentPlanName: string | undefined; /** *The name of the stage in the edge deployment plan.
* @public */ StageName: string | undefined; /** *The name of the deployed stage.
* @public */ DeployedStageName?: string | undefined; /** *The name of the fleet to which the device belongs to.
* @public */ DeviceFleetName?: string | undefined; /** *The name of the device.
* @public */ DeviceName: string | undefined; /** *The ARN of the device.
* @public */ DeviceArn: string | undefined; /** *The deployment status of the device.
* @public */ DeviceDeploymentStatus?: DeviceDeploymentStatus | undefined; /** *The detailed error message for the deployoment status result.
* @public */ DeviceDeploymentStatusMessage?: string | undefined; /** *The description of the device.
* @public */ Description?: string | undefined; /** *The time when the deployment on the device started.
* @public */ DeploymentStartTime?: Date | undefined; } /** *Summary of the device fleet.
* @public */ export interface DeviceFleetSummary { /** *Amazon Resource Name (ARN) of the device fleet.
* @public */ DeviceFleetArn: string | undefined; /** *Name of the device fleet.
* @public */ DeviceFleetName: string | undefined; /** *Timestamp of when the device fleet was created.
* @public */ CreationTime?: Date | undefined; /** *Timestamp of when the device fleet was last updated.
* @public */ LastModifiedTime?: Date | undefined; } /** *Status of devices.
* @public */ export interface DeviceStats { /** *The number of devices connected with a heartbeat.
* @public */ ConnectedDeviceCount: number | undefined; /** *The number of registered devices.
* @public */ RegisteredDeviceCount: number | undefined; } /** *Summary of model on edge device.
* @public */ export interface EdgeModelSummary { /** *The name of the model.
* @public */ ModelName: string | undefined; /** *The version model.
* @public */ ModelVersion: string | undefined; } /** *Summary of the device.
* @public */ export interface DeviceSummary { /** *The unique identifier of the device.
* @public */ DeviceName: string | undefined; /** *Amazon Resource Name (ARN) of the device.
* @public */ DeviceArn: string | undefined; /** *A description of the device.
* @public */ Description?: string | undefined; /** *The name of the fleet the device belongs to.
* @public */ DeviceFleetName?: string | undefined; /** *The Amazon Web Services Internet of Things (IoT) object thing name associated with the device..
* @public */ IotThingName?: string | undefined; /** *The timestamp of the last registration or de-reregistration.
* @public */ RegistrationTime?: Date | undefined; /** *The last heartbeat received from the device.
* @public */ LatestHeartbeat?: Date | undefined; /** *Models on the device.
* @public */ Models?: EdgeModelSummary[] | undefined; /** *Edge Manager agent version.
* @public */ AgentVersion?: string | undefined; } /** * @public * @enum */ export declare const Direction: { readonly ASCENDANTS: "Ascendants"; readonly BOTH: "Both"; readonly DESCENDANTS: "Descendants"; }; /** * @public */ export type Direction = (typeof Direction)[keyof typeof Direction]; /** * @public */ export interface DisableSagemakerServicecatalogPortfolioInput { } /** * @public */ export interface DisableSagemakerServicecatalogPortfolioOutput { } /** * @public */ export interface DisassociateTrialComponentRequest { /** *The name of the component to disassociate from the trial.
* @public */ TrialComponentName: string | undefined; /** *The name of the trial to disassociate from.
* @public */ TrialName: string | undefined; } /** * @public */ export interface DisassociateTrialComponentResponse { /** *The Amazon Resource Name (ARN) of the trial component.
* @public */ TrialComponentArn?: string | undefined; /** *The Amazon Resource Name (ARN) of the trial.
* @public */ TrialArn?: string | undefined; } /** *The domain's details.
* @public */ export interface DomainDetails { /** *The domain's Amazon Resource Name (ARN).
* @public */ DomainArn?: string | undefined; /** *The domain ID.
* @public */ DomainId?: string | undefined; /** *The domain name.
* @public */ DomainName?: string | undefined; /** *The status.
* @public */ Status?: DomainStatus | undefined; /** *The creation time.
* @public */ CreationTime?: Date | undefined; /** *The last modified time.
* @public */ LastModifiedTime?: Date | undefined; /** *The domain's URL.
* @public */ Url?: string | undefined; } /** *A collection of settings that update the current configuration for the RStudioServerPro Domain-level app.
The execution role for the RStudioServerPro Domain-level app.
Specifies the ARN's of a SageMaker AI image and SageMaker AI image version, and the instance type that the version runs on.
When both SageMakerImageVersionArn and SageMakerImageArn are passed, SageMakerImageVersionArn is used. Any updates to SageMakerImageArn will not take effect if SageMakerImageVersionArn already exists in the ResourceSpec because SageMakerImageVersionArn always takes precedence. To clear the value set for SageMakerImageVersionArn, pass None as the value.
A URL pointing to an RStudio Connect server.
* @public */ RStudioConnectUrl?: string | undefined; /** *A URL pointing to an RStudio Package Manager server.
* @public */ RStudioPackageManagerUrl?: string | undefined; } /** *A collection of Domain configuration settings to update.
A collection of RStudioServerPro Domain-level app settings to update. A single RStudioServerPro application is created for a domain.
The configuration for attaching a SageMaker AI user profile name to the execution role as a sts:SourceIdentity key. This configuration can only be modified if there are no apps in the InService or Pending state.
The security groups for the Amazon Virtual Private Cloud that the Domain uses for communication between Domain-level apps and user apps.
The Trusted Identity Propagation (TIP) settings for the SageMaker domain. These settings determine how user identities from IAM Identity Center are propagated through the domain to TIP enabled Amazon Web Services services.
* @public */ TrustedIdentityPropagationSettings?: TrustedIdentityPropagationSettings | undefined; /** *A collection of settings that configure the domain's Docker interaction.
* @public */ DockerSettings?: DockerSettings | undefined; /** *A collection of settings that configure the Amazon Q experience within the domain.
* @public */ AmazonQSettings?: AmazonQSettings | undefined; /** *The settings that apply to an SageMaker AI domain when you use it in Amazon SageMaker Unified Studio.
* @public */ UnifiedStudioSettings?: UnifiedStudioSettings | undefined; } /** *A specification for a predefined metric.
* @public */ export interface PredefinedMetricSpecification { /** *The metric type. You can only apply SageMaker metric types to SageMaker endpoints.
* @public */ PredefinedMetricType?: string | undefined; } /** *An object containing information about a metric.
* @public */ export type MetricSpecification = MetricSpecification.CustomizedMember | MetricSpecification.PredefinedMember | MetricSpecification.$UnknownMember; /** * @public */ export declare namespace MetricSpecification { /** *Information about a predefined metric.
* @public */ interface PredefinedMember { Predefined: PredefinedMetricSpecification; Customized?: never; $unknown?: never; } /** *Information about a customized metric.
* @public */ interface CustomizedMember { Predefined?: never; Customized: CustomizedMetricSpecification; $unknown?: never; } /** * @public */ interface $UnknownMember { Predefined?: never; Customized?: never; $unknown: [string, any]; } interface VisitorA target tracking scaling policy. Includes support for predefined or customized metrics.
When using the PutScalingPolicy API, this parameter is required when you are creating a policy with the policy type TargetTrackingScaling.
An object containing information about a metric.
* @public */ MetricSpecification?: MetricSpecification | undefined; /** *The recommended target value to specify for the metric when creating a scaling policy.
* @public */ TargetValue?: number | undefined; } /** *An object containing a recommended scaling policy.
* @public */ export type ScalingPolicy = ScalingPolicy.TargetTrackingMember | ScalingPolicy.$UnknownMember; /** * @public */ export declare namespace ScalingPolicy { /** *A target tracking scaling policy. Includes support for predefined or customized metrics.
* @public */ interface TargetTrackingMember { TargetTracking: TargetTrackingScalingPolicyConfiguration; $unknown?: never; } /** * @public */ interface $UnknownMember { TargetTracking?: never; $unknown: [string, any]; } interface VisitorAn object with the recommended values for you to specify when creating an autoscaling policy.
* @public */ export interface DynamicScalingConfiguration { /** *The recommended minimum capacity to specify for your autoscaling policy.
* @public */ MinCapacity?: number | undefined; /** *The recommended maximum capacity to specify for your autoscaling policy.
* @public */ MaxCapacity?: number | undefined; /** *The recommended scale in cooldown time for your autoscaling policy.
* @public */ ScaleInCooldown?: number | undefined; /** *The recommended scale out cooldown time for your autoscaling policy.
* @public */ ScaleOutCooldown?: number | undefined; /** *An object of the scaling policies for each metric.
* @public */ ScalingPolicies?: ScalingPolicy[] | undefined; } /** *A directed edge connecting two lineage entities.
* @public */ export interface Edge { /** *The Amazon Resource Name (ARN) of the source lineage entity of the directed edge.
* @public */ SourceArn?: string | undefined; /** *The Amazon Resource Name (ARN) of the destination lineage entity of the directed edge.
* @public */ DestinationArn?: string | undefined; /** *The type of the Association(Edge) between the source and destination. For example ContributedTo, Produced, or DerivedFrom.
Contains information summarizing an edge deployment plan.
* @public */ export interface EdgeDeploymentPlanSummary { /** *The ARN of the edge deployment plan.
* @public */ EdgeDeploymentPlanArn: string | undefined; /** *The name of the edge deployment plan.
* @public */ EdgeDeploymentPlanName: string | undefined; /** *The name of the device fleet used for the deployment.
* @public */ DeviceFleetName: string | undefined; /** *The number of edge devices with the successful deployment.
* @public */ EdgeDeploymentSuccess: number | undefined; /** *The number of edge devices yet to pick up the deployment, or in progress.
* @public */ EdgeDeploymentPending: number | undefined; /** *The number of edge devices that failed the deployment.
* @public */ EdgeDeploymentFailed: number | undefined; /** *The time when the edge deployment plan was created.
* @public */ CreationTime?: Date | undefined; /** *The time when the edge deployment plan was last updated.
* @public */ LastModifiedTime?: Date | undefined; } /** *Status of edge devices with this model.
* @public */ export interface EdgeModelStat { /** *The name of the model.
* @public */ ModelName: string | undefined; /** *The model version.
* @public */ ModelVersion: string | undefined; /** *The number of devices that have this model version and do not have a heart beat.
* @public */ OfflineDeviceCount: number | undefined; /** *The number of devices that have this model version and have a heart beat.
* @public */ ConnectedDeviceCount: number | undefined; /** *The number of devices that have this model version, a heart beat, and are currently running.
* @public */ ActiveDeviceCount: number | undefined; /** *The number of devices with this model version and are producing sample data.
* @public */ SamplingDeviceCount: number | undefined; } /** *Summary of edge packaging job.
* @public */ export interface EdgePackagingJobSummary { /** *The Amazon Resource Name (ARN) of the edge packaging job.
* @public */ EdgePackagingJobArn: string | undefined; /** *The name of the edge packaging job.
* @public */ EdgePackagingJobName: string | undefined; /** *The status of the edge packaging job.
* @public */ EdgePackagingJobStatus: EdgePackagingJobStatus | undefined; /** *The name of the SageMaker Neo compilation job.
* @public */ CompilationJobName?: string | undefined; /** *The name of the model.
* @public */ ModelName?: string | undefined; /** *The version of the model.
* @public */ ModelVersion?: string | undefined; /** *The timestamp of when the job was created.
* @public */ CreationTime?: Date | undefined; /** *The timestamp of when the edge packaging job was last updated.
* @public */ LastModifiedTime?: Date | undefined; } /** *The configurations and outcomes of an Amazon EMR step execution.
* @public */ export interface EMRStepMetadata { /** *The identifier of the EMR cluster.
* @public */ ClusterId?: string | undefined; /** *The identifier of the EMR cluster step.
* @public */ StepId?: string | undefined; /** *The name of the EMR cluster step.
* @public */ StepName?: string | undefined; /** *The path to the log file where the cluster step's failure root cause is recorded.
* @public */ LogFilePath?: string | undefined; } /** * @public */ export interface EnableSagemakerServicecatalogPortfolioInput { } /** * @public */ export interface EnableSagemakerServicecatalogPortfolioOutput { } /** *A schedule for a model monitoring job. For information about model monitor, see Amazon SageMaker Model Monitor.
* @public */ export interface MonitoringSchedule { /** *The Amazon Resource Name (ARN) of the monitoring schedule.
* @public */ MonitoringScheduleArn?: string | undefined; /** *The name of the monitoring schedule.
* @public */ MonitoringScheduleName?: string | undefined; /** *The status of the monitoring schedule. This can be one of the following values.
PENDING - The schedule is pending being created.
FAILED - The schedule failed.
SCHEDULED - The schedule was successfully created.
STOPPED - The schedule was stopped.
The type of the monitoring job definition to schedule.
* @public */ MonitoringType?: MonitoringType | undefined; /** *If the monitoring schedule failed, the reason it failed.
* @public */ FailureReason?: string | undefined; /** *The time that the monitoring schedule was created.
* @public */ CreationTime?: Date | undefined; /** *The last time the monitoring schedule was changed.
* @public */ LastModifiedTime?: Date | undefined; /** *Configures the monitoring schedule and defines the monitoring job.
* @public */ MonitoringScheduleConfig?: MonitoringScheduleConfig | undefined; /** *The endpoint that hosts the model being monitored.
* @public */ EndpointName?: string | undefined; /** *Summary of information about the last monitoring job to run.
* @public */ LastMonitoringExecutionSummary?: MonitoringExecutionSummary | undefined; /** *A list of the tags associated with the monitoring schedlue. For more information, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference Guide.
* @public */ Tags?: Tag[] | undefined; } /** *A hosted endpoint for real-time inference.
* @public */ export interface Endpoint { /** *The name of the endpoint.
* @public */ EndpointName: string | undefined; /** *The Amazon Resource Name (ARN) of the endpoint.
* @public */ EndpointArn: string | undefined; /** *The endpoint configuration associated with the endpoint.
* @public */ EndpointConfigName: string | undefined; /** *A list of the production variants hosted on the endpoint. Each production variant is a model.
* @public */ ProductionVariants?: ProductionVariantSummary[] | undefined; /** *The currently active data capture configuration used by your Endpoint.
* @public */ DataCaptureConfig?: DataCaptureConfigSummary | undefined; /** *The status of the endpoint.
* @public */ EndpointStatus: EndpointStatus | undefined; /** *If the endpoint failed, the reason it failed.
* @public */ FailureReason?: string | undefined; /** *The time that the endpoint was created.
* @public */ CreationTime: Date | undefined; /** *The last time the endpoint was modified.
* @public */ LastModifiedTime: Date | undefined; /** *A list of monitoring schedules for the endpoint. For information about model monitoring, see Amazon SageMaker Model Monitor.
* @public */ MonitoringSchedules?: MonitoringSchedule[] | undefined; /** *A list of the tags associated with the endpoint. For more information, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference Guide.
* @public */ Tags?: Tag[] | undefined; /** *A list of the shadow variants hosted on the endpoint. Each shadow variant is a model in shadow mode with production traffic replicated from the production variant.
* @public */ ShadowProductionVariants?: ProductionVariantSummary[] | undefined; } /** * @public * @enum */ export declare const EndpointConfigSortKey: { readonly CreationTime: "CreationTime"; readonly Name: "Name"; }; /** * @public */ export type EndpointConfigSortKey = (typeof EndpointConfigSortKey)[keyof typeof EndpointConfigSortKey]; /** *Metadata for an endpoint configuration step.
* @public */ export interface EndpointConfigStepMetadata { /** *The Amazon Resource Name (ARN) of the endpoint configuration used in the step.
* @public */ Arn?: string | undefined; } /** *Provides summary information for an endpoint configuration.
* @public */ export interface EndpointConfigSummary { /** *The name of the endpoint configuration.
* @public */ EndpointConfigName: string | undefined; /** *The Amazon Resource Name (ARN) of the endpoint configuration.
* @public */ EndpointConfigArn: string | undefined; /** *A timestamp that shows when the endpoint configuration was created.
* @public */ CreationTime: Date | undefined; } /** * @public * @enum */ export declare const EndpointSortKey: { readonly CreationTime: "CreationTime"; readonly Name: "Name"; readonly Status: "Status"; }; /** * @public */ export type EndpointSortKey = (typeof EndpointSortKey)[keyof typeof EndpointSortKey]; /** *Metadata for an endpoint step.
* @public */ export interface EndpointStepMetadata { /** *The Amazon Resource Name (ARN) of the endpoint in the step.
* @public */ Arn?: string | undefined; } /** *Provides summary information for an endpoint.
* @public */ export interface EndpointSummary { /** *The name of the endpoint.
* @public */ EndpointName: string | undefined; /** *The Amazon Resource Name (ARN) of the endpoint.
* @public */ EndpointArn: string | undefined; /** *A timestamp that shows when the endpoint was created.
* @public */ CreationTime: Date | undefined; /** *A timestamp that shows when the endpoint was last modified.
* @public */ LastModifiedTime: Date | undefined; /** *The status of the endpoint.
OutOfService: Endpoint is not available to take incoming requests.
Creating: CreateEndpoint is executing.
Updating: UpdateEndpoint or UpdateEndpointWeightsAndCapacities is executing.
SystemUpdating: Endpoint is undergoing maintenance and cannot be updated or deleted or re-scaled until it has completed. This maintenance operation does not change any customer-specified values such as VPC config, KMS encryption, model, instance type, or instance count.
RollingBack: Endpoint fails to scale up or down or change its variant weight and is in the process of rolling back to its previous configuration. Once the rollback completes, endpoint returns to an InService status. This transitional status only applies to an endpoint that has autoscaling enabled and is undergoing variant weight or capacity changes as part of an UpdateEndpointWeightsAndCapacities call or when the UpdateEndpointWeightsAndCapacities operation is called explicitly.
InService: Endpoint is available to process incoming requests.
Deleting: DeleteEndpoint is executing.
Failed: Endpoint could not be created, updated, or re-scaled. Use DescribeEndpointOutput$FailureReason for information about the failure. DeleteEndpoint is the only operation that can be performed on a failed endpoint.
To get a list of endpoints with a specified status, use the StatusEquals filter with a call to ListEndpoints.
The properties of an experiment as returned by the Search API. For information about experiments, see the CreateExperiment API.
* @public */ export interface Experiment { /** *The name of the experiment.
* @public */ ExperimentName?: string | undefined; /** *The Amazon Resource Name (ARN) of the experiment.
* @public */ ExperimentArn?: string | undefined; /** *The name of the experiment as displayed. If DisplayName isn't specified, ExperimentName is displayed.
The source of the experiment.
* @public */ Source?: ExperimentSource | undefined; /** *The description of the experiment.
* @public */ Description?: string | undefined; /** *When the experiment was created.
* @public */ CreationTime?: Date | undefined; /** *Who created the experiment.
* @public */ CreatedBy?: UserContext | undefined; /** *When the experiment was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *Information about the user who created or modified a SageMaker resource.
* @public */ LastModifiedBy?: UserContext | undefined; /** *The list of tags that are associated with the experiment. You can use Search API to search on the tags.
* @public */ Tags?: Tag[] | undefined; } /** *A summary of the properties of an experiment. To get the complete set of properties, call the DescribeExperiment API and provide the ExperimentName.
The Amazon Resource Name (ARN) of the experiment.
* @public */ ExperimentArn?: string | undefined; /** *The name of the experiment.
* @public */ ExperimentName?: string | undefined; /** *The name of the experiment as displayed. If DisplayName isn't specified, ExperimentName is displayed.
The source of the experiment.
* @public */ ExperimentSource?: ExperimentSource | undefined; /** *When the experiment was created.
* @public */ CreationTime?: Date | undefined; /** *When the experiment was last modified.
* @public */ LastModifiedTime?: Date | undefined; } /** *The container for the metadata for Fail step.
* @public */ export interface FailStepMetadata { /** *A message that you define and then is processed and rendered by the Fail step when the error occurs.
* @public */ ErrorMessage?: string | undefined; } /** *Amazon SageMaker Feature Store stores features in a collection called Feature Group. A Feature Group can be visualized as a table which has rows, with a unique identifier for each row where each column in the table is a feature. In principle, a Feature Group is composed of features and values per features.
* @public */ export interface FeatureGroup { /** *The Amazon Resource Name (ARN) of a FeatureGroup.
The name of the FeatureGroup.
The name of the Feature whose value uniquely identifies a Record defined in the FeatureGroup FeatureDefinitions.
The name of the feature that stores the EventTime of a Record in a FeatureGroup.
A EventTime is point in time when a new event occurs that corresponds to the creation or update of a Record in FeatureGroup. All Records in the FeatureGroup must have a corresponding EventTime.
A list of Features. Each Feature must include a FeatureName and a FeatureType.
Valid FeatureTypes are Integral, Fractional and String.
FeatureNames cannot be any of the following: is_deleted, write_time, api_invocation_time.
You can create up to 2,500 FeatureDefinitions per FeatureGroup.
The time a FeatureGroup was created.
A timestamp indicating the last time you updated the feature group.
* @public */ LastModifiedTime?: Date | undefined; /** *Use this to specify the Amazon Web Services Key Management Service (KMS) Key ID, or KMSKeyId, for at rest data encryption. You can turn OnlineStore on or off by specifying the EnableOnlineStore flag at General Assembly.
The default value is False.
The configuration of an OfflineStore.
Provide an OfflineStoreConfig in a request to CreateFeatureGroup to create an OfflineStore.
To encrypt an OfflineStore using at rest data encryption, specify Amazon Web Services Key Management Service (KMS) key ID, or KMSKeyId, in S3StorageConfig.
The Amazon Resource Name (ARN) of the IAM execution role used to create the feature group.
* @public */ RoleArn?: string | undefined; /** *A FeatureGroup status.
The status of OfflineStore.
A value that indicates whether the feature group was updated successfully.
* @public */ LastUpdateStatus?: LastUpdateStatus | undefined; /** *The reason that the FeatureGroup failed to be replicated in the OfflineStore. This is failure may be due to a failure to create a FeatureGroup in or delete a FeatureGroup from the OfflineStore.
A free form description of a FeatureGroup.
Tags used to define a FeatureGroup.
The name, ARN, CreationTime, FeatureGroup values, LastUpdatedTime and EnableOnlineStorage status of a FeatureGroup.
The name of FeatureGroup.
Unique identifier for the FeatureGroup.
A timestamp indicating the time of creation time of the FeatureGroup.
The status of a FeatureGroup. The status can be any of the following: Creating, Created, CreateFail, Deleting or DetailFail.
Notifies you if replicating data into the OfflineStore has failed. Returns either: Active or Blocked.
The metadata for a feature. It can either be metadata that you specify, or metadata that is updated automatically.
* @public */ export interface FeatureMetadata { /** *The Amazon Resource Number (ARN) of the feature group.
* @public */ FeatureGroupArn?: string | undefined; /** *The name of the feature group containing the feature.
* @public */ FeatureGroupName?: string | undefined; /** *The name of feature.
* @public */ FeatureName?: string | undefined; /** *The data type of the feature.
* @public */ FeatureType?: FeatureType | undefined; /** *A timestamp indicating when the feature was created.
* @public */ CreationTime?: Date | undefined; /** *A timestamp indicating when the feature was last modified.
* @public */ LastModifiedTime?: Date | undefined; /** *An optional description that you specify to better describe the feature.
* @public */ Description?: string | undefined; /** *Optional key-value pairs that you specify to better describe the feature.
* @public */ Parameters?: FeatureParameter[] | undefined; } /** * @public * @enum */ export declare const Operator: { readonly CONTAINS: "Contains"; readonly EQUALS: "Equals"; readonly EXISTS: "Exists"; readonly GREATER_THAN: "GreaterThan"; readonly GREATER_THAN_OR_EQUAL_TO: "GreaterThanOrEqualTo"; readonly IN: "In"; readonly LESS_THAN: "LessThan"; readonly LESS_THAN_OR_EQUAL_TO: "LessThanOrEqualTo"; readonly NOT_EQUALS: "NotEquals"; readonly NOT_EXISTS: "NotExists"; }; /** * @public */ export type Operator = (typeof Operator)[keyof typeof Operator]; /** *A conditional statement for a search expression that includes a resource property, a Boolean operator, and a value. Resources that match the statement are returned in the results from the Search API.
If you specify a Value, but not an Operator, SageMaker uses the equals operator.
In search, there are several property types:
To define a metric filter, enter a value using the form "Metrics.<name>", where <name> is a metric name. For example, the following filter searches for training jobs with an "accuracy" metric greater than "0.9":
\{
"Name": "Metrics.accuracy",
"Operator": "GreaterThan",
"Value": "0.9"
\}
To define a hyperparameter filter, enter a value with the form "HyperParameters.<name>". Decimal hyperparameter values are treated as a decimal in a comparison if the specified Value is also a decimal value. If the specified Value is an integer, the decimal hyperparameter values are treated as integers. For example, the following filter is satisfied by training jobs with a "learning_rate" hyperparameter that is less than "0.5":
\{
"Name": "HyperParameters.learning_rate",
"Operator": "LessThan",
"Value": "0.5"
\}
To define a tag filter, enter a value with the form Tags.<key>.
A resource property name. For example, TrainingJobName. For valid property names, see SearchRecord. You must specify a valid property for the resource.
A Boolean binary operator that is used to evaluate the filter. The operator field contains one of the following values:
The value of Name equals Value.
The value of Name doesn't equal Value.
The Name property exists.
The Name property does not exist.
The value of Name is greater than Value. Not supported for text properties.
The value of Name is greater than or equal to Value. Not supported for text properties.
The value of Name is less than Value. Not supported for text properties.
The value of Name is less than or equal to Value. Not supported for text properties.
The value of Name is one of the comma delimited strings in Value. Only supported for text properties.
The value of Name contains the string Value. Only supported for text properties.
A SearchExpression can include the Contains operator multiple times when the value of Name is one of the following:
Experiment.DisplayName
Experiment.ExperimentName
Experiment.Tags
Trial.DisplayName
Trial.TrialName
Trial.Tags
TrialComponent.DisplayName
TrialComponent.TrialComponentName
TrialComponent.Tags
TrialComponent.InputArtifacts
TrialComponent.OutputArtifacts
A SearchExpression can include only one Contains operator for all other values of Name. In these cases, if you include multiple Contains operators in the SearchExpression, the result is the following error message: "'CONTAINS' operator usage limit of 1 exceeded."
A value used with Name and Operator to determine which resources satisfy the filter's condition. For numerical properties, Value must be an integer or floating-point decimal. For timestamp properties, Value must be an ISO 8601 date-time string of the following format: YYYY-mm-dd'T'HH:MM:SS.
Contains summary information about the flow definition.
* @public */ export interface FlowDefinitionSummary { /** *The name of the flow definition.
* @public */ FlowDefinitionName: string | undefined; /** *The Amazon Resource Name (ARN) of the flow definition.
* @public */ FlowDefinitionArn: string | undefined; /** *The status of the flow definition. Valid values:
* @public */ FlowDefinitionStatus: FlowDefinitionStatus | undefined; /** *The timestamp when SageMaker created the flow definition.
* @public */ CreationTime: Date | undefined; /** *The reason why the flow definition creation failed. A failure reason is returned only when the flow definition status is Failed.
The name of the fleet.
* @public */ DeviceFleetName: string | undefined; } /** * @public */ export interface GetDeviceFleetReportResponse { /** *The Amazon Resource Name (ARN) of the device.
* @public */ DeviceFleetArn: string | undefined; /** *The name of the fleet.
* @public */ DeviceFleetName: string | undefined; /** *The output configuration for storing sample data collected by the fleet.
* @public */ OutputConfig?: EdgeOutputConfig | undefined; /** *Description of the fleet.
* @public */ Description?: string | undefined; /** *Timestamp of when the report was generated.
* @public */ ReportGenerated?: Date | undefined; /** *Status of devices.
* @public */ DeviceStats?: DeviceStats | undefined; /** *The versions of Edge Manager agent deployed on the fleet.
* @public */ AgentVersions?: AgentVersion[] | undefined; /** *Status of model on device.
* @public */ ModelStats?: EdgeModelStat[] | undefined; } /** * @public */ export interface GetLineageGroupPolicyRequest { /** *The name or Amazon Resource Name (ARN) of the lineage group.
* @public */ LineageGroupName: string | undefined; } /** * @public */ export interface GetLineageGroupPolicyResponse { /** *The Amazon Resource Name (ARN) of the lineage group.
* @public */ LineageGroupArn?: string | undefined; /** *The resource policy that gives access to the lineage group in another account.
* @public */ ResourcePolicy?: string | undefined; } /** * @public */ export interface GetModelPackageGroupPolicyInput { /** *The name of the model group for which to get the resource policy.
* @public */ ModelPackageGroupName: string | undefined; } /** * @public */ export interface GetModelPackageGroupPolicyOutput { /** *The resource policy for the model group.
* @public */ ResourcePolicy: string | undefined; } /** * @public */ export interface GetSagemakerServicecatalogPortfolioStatusInput { } /** * @public * @enum */ export declare const SagemakerServicecatalogStatus: { readonly DISABLED: "Disabled"; readonly ENABLED: "Enabled"; }; /** * @public */ export type SagemakerServicecatalogStatus = (typeof SagemakerServicecatalogStatus)[keyof typeof SagemakerServicecatalogStatus]; /** * @public */ export interface GetSagemakerServicecatalogPortfolioStatusOutput { /** *Whether Service Catalog is enabled or disabled in SageMaker.
* @public */ Status?: SagemakerServicecatalogStatus | undefined; } /** *An object where you specify the anticipated traffic pattern for an endpoint.
* @public */ export interface ScalingPolicyObjective { /** *The minimum number of expected requests to your endpoint per minute.
* @public */ MinInvocationsPerMinute?: number | undefined; /** *The maximum number of expected requests to your endpoint per minute.
* @public */ MaxInvocationsPerMinute?: number | undefined; } /** * @public */ export interface GetScalingConfigurationRecommendationRequest { /** *The name of a previously completed Inference Recommender job.
* @public */ InferenceRecommendationsJobName: string | undefined; /** *The recommendation ID of a previously completed inference recommendation. This ID should come from one of the recommendations returned by the job specified in the InferenceRecommendationsJobName field.
Specify either this field or the EndpointName field.
The name of an endpoint benchmarked during a previously completed inference recommendation job. This name should come from one of the recommendations returned by the job specified in the InferenceRecommendationsJobName field.
Specify either this field or the RecommendationId field.
The percentage of how much utilization you want an instance to use before autoscaling. The default value is 50%.
* @public */ TargetCpuUtilizationPerCore?: number | undefined; /** *An object where you specify the anticipated traffic pattern for an endpoint.
* @public */ ScalingPolicyObjective?: ScalingPolicyObjective | undefined; } /** *The metric for a scaling policy.
* @public */ export interface ScalingPolicyMetric { /** *The number of invocations sent to a model, normalized by InstanceCount in each ProductionVariant. 1/numberOfInstances is sent as the value on each request, where numberOfInstances is the number of active instances for the ProductionVariant behind the endpoint at the time of the request.
The interval of time taken by a model to respond as viewed from SageMaker. This interval includes the local communication times taken to send the request and to fetch the response from the container of a model and the time taken to complete the inference in the container.
* @public */ ModelLatency?: number | undefined; } /** * @public */ export interface GetScalingConfigurationRecommendationResponse { /** *The name of a previously completed Inference Recommender job.
* @public */ InferenceRecommendationsJobName?: string | undefined; /** *The recommendation ID of a previously completed inference recommendation.
* @public */ RecommendationId?: string | undefined; /** *The name of an endpoint benchmarked during a previously completed Inference Recommender job.
* @public */ EndpointName?: string | undefined; /** *The percentage of how much utilization you want an instance to use before autoscaling, which you specified in the request. The default value is 50%.
* @public */ TargetCpuUtilizationPerCore?: number | undefined; /** *An object representing the anticipated traffic pattern for an endpoint that you specified in the request.
* @public */ ScalingPolicyObjective?: ScalingPolicyObjective | undefined; /** *An object with a list of metrics that were benchmarked during the previously completed Inference Recommender job.
* @public */ Metric?: ScalingPolicyMetric | undefined; /** *An object with the recommended values for you to specify when creating an autoscaling policy.
* @public */ DynamicScalingConfiguration?: DynamicScalingConfiguration | undefined; } /** * @public * @enum */ export declare const ResourceType: { readonly ENDPOINT: "Endpoint"; readonly EXPERIMENT: "Experiment"; readonly EXPERIMENT_TRIAL: "ExperimentTrial"; readonly EXPERIMENT_TRIAL_COMPONENT: "ExperimentTrialComponent"; readonly FEATURE_GROUP: "FeatureGroup"; readonly FEATURE_METADATA: "FeatureMetadata"; readonly HYPER_PARAMETER_TUNING_JOB: "HyperParameterTuningJob"; readonly IMAGE: "Image"; readonly IMAGE_VERSION: "ImageVersion"; readonly MODEL: "Model"; readonly MODEL_CARD: "ModelCard"; readonly MODEL_PACKAGE: "ModelPackage"; readonly MODEL_PACKAGE_GROUP: "ModelPackageGroup"; readonly PIPELINE: "Pipeline"; readonly PIPELINE_EXECUTION: "PipelineExecution"; readonly PIPELINE_VERSION: "PipelineVersion"; readonly PROJECT: "Project"; readonly TRAINING_JOB: "TrainingJob"; }; /** * @public */ export type ResourceType = (typeof ResourceType)[keyof typeof ResourceType]; /** *Part of the SuggestionQuery type. Specifies a hint for retrieving property names that begin with the specified text.
Text that begins a property's name.
* @public */ PropertyNameHint: string | undefined; } /** *Specified in the GetSearchSuggestions request. Limits the property names that are included in the response.
* @public */ export interface SuggestionQuery { /** *Defines a property name hint. Only property names that begin with the specified hint are included in the response.
* @public */ PropertyNameQuery?: PropertyNameQuery | undefined; } /** * @public */ export interface GetSearchSuggestionsRequest { /** *The name of the SageMaker resource to search for.
* @public */ Resource: ResourceType | undefined; /** *Limits the property names that are included in the response.
* @public */ SuggestionQuery?: SuggestionQuery | undefined; } /** *A property name returned from a GetSearchSuggestions call that specifies a value in the PropertyNameQuery field.
A suggested property name based on what you entered in the search textbox in the SageMaker console.
* @public */ PropertyName?: string | undefined; } /** * @public */ export interface GetSearchSuggestionsResponse { /** *A list of property names for a Resource that match a SuggestionQuery.
Specifies configuration details for a Git repository when the repository is updated.
* @public */ export interface GitConfigForUpdate { /** *The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret that contains the credentials used to access the git repository. The secret must have a staging label of AWSCURRENT and must be in the following format:
\{"username": UserName, "password": Password\}
Information about hub content.
* @public */ export interface HubContentInfo { /** *The name of the hub content.
* @public */ HubContentName: string | undefined; /** *The Amazon Resource Name (ARN) of the hub content.
* @public */ HubContentArn: string | undefined; /** *The ARN of the public hub content.
* @public */ SageMakerPublicHubContentArn?: string | undefined; /** *The version of the hub content.
* @public */ HubContentVersion: string | undefined; /** *The type of hub content.
* @public */ HubContentType: HubContentType | undefined; /** *The version of the hub content document schema.
* @public */ DocumentSchemaVersion: string | undefined; /** *The display name of the hub content.
* @public */ HubContentDisplayName?: string | undefined; /** *A description of the hub content.
* @public */ HubContentDescription?: string | undefined; /** *The support status of the hub content.
* @public */ SupportStatus?: HubContentSupportStatus | undefined; /** *The searchable keywords for the hub content.
* @public */ HubContentSearchKeywords?: string[] | undefined; /** *The status of the hub content.
* @public */ HubContentStatus: HubContentStatus | undefined; /** *The date and time that the hub content was created.
* @public */ CreationTime: Date | undefined; /** *The date and time when the hub content was originally created, before any updates or revisions.
* @public */ OriginalCreationTime?: Date | undefined; } /** * @public * @enum */ export declare const HubContentSortBy: { readonly CREATION_TIME: "CreationTime"; readonly HUB_CONTENT_NAME: "HubContentName"; readonly HUB_CONTENT_STATUS: "HubContentStatus"; }; /** * @public */ export type HubContentSortBy = (typeof HubContentSortBy)[keyof typeof HubContentSortBy]; /** * @internal */ export declare const DescribeModelCardResponseFilterSensitiveLog: (obj: DescribeModelCardResponse) => any; /** * @internal */ export declare const DescribeModelPackageOutputFilterSensitiveLog: (obj: DescribeModelPackageOutput) => any;