import { Command as $Command } from "@smithy/smithy-client"; import { MetadataBearer as __MetadataBearer } from "@smithy/types"; import { CreateTrialRequest, CreateTrialResponse } from "../models/models_2"; import { SageMakerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SageMakerClient"; /** * @public */ export type { __MetadataBearer }; export { $Command }; /** * @public * * The input for {@link CreateTrialCommand}. */ export interface CreateTrialCommandInput extends CreateTrialRequest { } /** * @public * * The output of {@link CreateTrialCommand}. */ export interface CreateTrialCommandOutput extends CreateTrialResponse, __MetadataBearer { } declare const CreateTrialCommand_base: { new (input: CreateTrialCommandInput): import("@smithy/smithy-client").CommandImpl; new (input: CreateTrialCommandInput): import("@smithy/smithy-client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; }; /** *

Creates an SageMaker trial. A trial is a set of steps called trial components that produce a machine learning model. A trial is part of a single SageMaker experiment.

When you use SageMaker Studio or the SageMaker Python SDK, all experiments, trials, and trial components are automatically tracked, logged, and indexed. When you use the Amazon Web Services SDK for Python (Boto), you must use the logging APIs provided by the SDK.

You can add tags to a trial and then use the Search API to search for the tags.

To get a list of all your trials, call the ListTrials API. To view a trial's properties, call the DescribeTrial API. To create a trial component, call the CreateTrialComponent API.

* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { SageMakerClient, CreateTrialCommand } from "@aws-sdk/client-sagemaker"; // ES Modules import * // const { SageMakerClient, CreateTrialCommand } = require("@aws-sdk/client-sagemaker"); // CommonJS import * const client = new SageMakerClient(config); * const input = { // CreateTrialRequest * TrialName: "STRING_VALUE", // required * DisplayName: "STRING_VALUE", * ExperimentName: "STRING_VALUE", // required * MetadataProperties: { // MetadataProperties * CommitId: "STRING_VALUE", * Repository: "STRING_VALUE", * GeneratedBy: "STRING_VALUE", * ProjectId: "STRING_VALUE", * }, * Tags: [ // TagList * { // Tag * Key: "STRING_VALUE", // required * Value: "STRING_VALUE", // required * }, * ], * }; * const command = new CreateTrialCommand(input); * const response = await client.send(command); * // { // CreateTrialResponse * // TrialArn: "STRING_VALUE", * // }; * * ``` * * @param CreateTrialCommandInput - {@link CreateTrialCommandInput} * @returns {@link CreateTrialCommandOutput} * @see {@link CreateTrialCommandInput} for command's `input` shape. * @see {@link CreateTrialCommandOutput} for command's `response` shape. * @see {@link SageMakerClientResolvedConfig | config} for SageMakerClient's `config` shape. * * @throws {@link ResourceLimitExceeded} (client fault) *

You have exceeded an SageMaker resource limit. For example, you might have too many training jobs created.

* * @throws {@link ResourceNotFound} (client fault) *

Resource being access is not found.

* * @throws {@link SageMakerServiceException} *

Base exception class for all service exceptions from SageMaker service.

* * * @public */ export declare class CreateTrialCommand extends CreateTrialCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: CreateTrialRequest; output: CreateTrialResponse; }; sdk: { input: CreateTrialCommandInput; output: CreateTrialCommandOutput; }; }; }