diff --git a/clients/client-sagemaker/README.md b/clients/client-sagemaker/README.md
index ca20a0d860e3d..4b537e4c60654 100644
--- a/clients/client-sagemaker/README.md
+++ b/clients/client-sagemaker/README.md
@@ -2049,6 +2049,14 @@ ListProjects
[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-sagemaker/classes/listprojectscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-sagemaker/interfaces/listprojectscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-sagemaker/interfaces/listprojectscommandoutput.html)
+
+
+ListResourceCatalogs
+
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-sagemaker/classes/listresourcecatalogscommand.html) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-sagemaker/interfaces/listresourcecatalogscommandinput.html) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/clients/client-sagemaker/interfaces/listresourcecatalogscommandoutput.html)
+
diff --git a/clients/client-sagemaker/src/SageMaker.ts b/clients/client-sagemaker/src/SageMaker.ts
index e2702de389fd3..4fd223c5771c3 100644
--- a/clients/client-sagemaker/src/SageMaker.ts
+++ b/clients/client-sagemaker/src/SageMaker.ts
@@ -1051,6 +1051,11 @@ import {
ListProjectsCommandInput,
ListProjectsCommandOutput,
} from "./commands/ListProjectsCommand";
+import {
+ ListResourceCatalogsCommand,
+ ListResourceCatalogsCommandInput,
+ ListResourceCatalogsCommandOutput,
+} from "./commands/ListResourceCatalogsCommand";
import { ListSpacesCommand, ListSpacesCommandInput, ListSpacesCommandOutput } from "./commands/ListSpacesCommand";
import {
ListStageDevicesCommand,
@@ -1616,6 +1621,7 @@ const commands = {
ListPipelinesCommand,
ListProcessingJobsCommand,
ListProjectsCommand,
+ ListResourceCatalogsCommand,
ListSpacesCommand,
ListStageDevicesCommand,
ListStudioLifecycleConfigsCommand,
@@ -5261,6 +5267,23 @@ export interface SageMaker {
cb: (err: any, data?: ListProjectsCommandOutput) => void
): void;
+ /**
+ * @see {@link ListResourceCatalogsCommand}
+ */
+ listResourceCatalogs(
+ args: ListResourceCatalogsCommandInput,
+ options?: __HttpHandlerOptions
+ ): Promise
FeatureGroup
definition is composed of a list of
* Features
, a RecordIdentifierFeatureName
, an
* EventTimeFeatureName
and configurations for its OnlineStore
- * and OfflineStore
. Check Amazon Web Services service quotas to see
- * the FeatureGroup
s quota for your Amazon Web Services account.
OfflineStore
. Check Amazon Web Services service
+ * quotas to see the FeatureGroup
s quota for your Amazon Web Services
+ * account.
* You must include at least one of OnlineStoreConfig
and
* OfflineStoreConfig
to create a FeatureGroup
.
Delete the FeatureGroup
and any data that was written to the
* OnlineStore
of the FeatureGroup
. Data cannot be accessed from
* the OnlineStore
immediately after DeleteFeatureGroup
is called.
Data written into the OfflineStore
will not be deleted. The Amazon Web Services Glue
- * database and tables that are automatically created for your OfflineStore
are
- * not deleted.
Data written into the OfflineStore
will not be deleted. The Amazon Web Services Glue database and tables that are automatically created for your
+ * OfflineStore
are not deleted.
Lists Amazon SageMaker Catalogs based on given filters and orders. The maximum number of
+ * ResourceCatalog
s viewable is 1000.
Base exception class for all service exceptions from SageMaker service.
+ * + */ +export class ListResourceCatalogsCommand extends $Command< + ListResourceCatalogsCommandInput, + ListResourceCatalogsCommandOutput, + SageMakerClientResolvedConfig +> { + // Start section: command_properties + // End section: command_properties + + public static getEndpointParameterInstructions(): EndpointParameterInstructions { + return { + UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" }, + Endpoint: { type: "builtInParams", name: "endpoint" }, + Region: { type: "builtInParams", name: "region" }, + UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" }, + }; + } + + /** + * @public + */ + constructor(readonly input: ListResourceCatalogsCommandInput) { + // Start section: command_constructor + super(); + // End section: command_constructor + } + + /** + * @internal + */ + resolveMiddleware( + clientStack: MiddlewareStackUpdates the feature group.
+ *Updates the feature group by either adding features or updating the online store
+ * configuration. Use one of the following request parameters at a time while using the
+ * UpdateFeatureGroup
API.
You can add features for your feature group using the FeatureAdditions
+ * request parameter. Features cannot be removed from a feature group.
You can update the online store configuration by using the
+ * OnlineStoreConfig
request parameter. If a TtlDuration
is
+ * specified, the default TtlDuration
applies for all records added to the
+ * feature group after the feature group is updated. If a record level
+ * TtlDuration
exists from using the PutRecord
API, the record
+ * level TtlDuration
applies to that record instead of the default
+ * TtlDuration
.
The Amazon Simple Storage (Amazon S3) location and and security configuration for OfflineStore
.
The Amazon Simple Storage (Amazon S3) location and and security configuration for
+ * OfflineStore
.
The S3 URI, or location in Amazon S3, of OfflineStore
.
S3 URIs have a format similar to the following: s3://example-bucket/prefix/
.
S3 URIs have a format similar to the following:
+ * s3://example-bucket/prefix/
.
The Amazon Web Services Key Management Service (KMS) key ARN of the key used to encrypt any objects
- * written into the OfflineStore
S3 location.
The Amazon Web Services Key Management Service (KMS) key ARN of the key used to encrypt
+ * any objects written into the OfflineStore
S3 location.
The IAM roleARN
that is passed as a parameter to
* CreateFeatureGroup
must have below permissions to the
* KmsKeyId
:
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
.
To encrypt an OfflineStore
using at rest data encryption, specify Amazon Web Services Key Management Service (KMS) key ID, or KMSKeyId
, in
+ * S3StorageConfig
.
Set to True
to disable the automatic creation of an Amazon Web Services Glue table when
- * configuring an OfflineStore
. If set to False
, Feature Store will name the
- * OfflineStore
Glue table following
- * Athena's naming recommendations.
Set to True
to disable the automatic creation of an Amazon Web Services Glue
+ * table when configuring an OfflineStore
. If set to False
, Feature
+ * Store will name the OfflineStore
Glue table following Athena's
+ * naming recommendations.
The default value is False
.
The Amazon Web Services Key Management Service (KMS) key ARN that SageMaker Feature Store uses - * to encrypt the Amazon S3 objects at rest using Amazon S3 server-side encryption.
- *The caller (either user or IAM role) of CreateFeatureGroup
must have
- * below permissions to the OnlineStore
+ *
The Amazon Web Services Key Management Service (KMS) key ARN that SageMaker Feature Store + * uses to encrypt the Amazon S3 objects at rest using Amazon S3 server-side + * encryption.
+ *The caller (either user or IAM role) of CreateFeatureGroup
must have below
+ * permissions to the OnlineStore
* KmsKeyId
:
The caller (either user or IAM role) to all DataPlane operations
- * (PutRecord
, GetRecord
, DeleteRecord
) must have
- * the following permissions to the KmsKeyId
:
PutRecord
, GetRecord
, DeleteRecord
) must have the
+ * following permissions to the KmsKeyId
:
* @@ -1395,10 +1397,9 @@ export interface OnlineStoreConfig { SecurityConfig?: OnlineStoreSecurityConfig; /** - *
Turn OnlineStore
off by specifying False
- * for the EnableOnlineStore
flag. Turn OnlineStore
- * on by specifying True
- * for the EnableOnlineStore
flag.
Turn OnlineStore
off by specifying False
for the
+ * EnableOnlineStore
flag. Turn OnlineStore
on by specifying
+ * True
for the EnableOnlineStore
flag.
The default value is False
.
The name of the FeatureGroup
. The name must be unique within an Amazon Web Services Region
- * in an Amazon Web Services account. The name:
The name of the FeatureGroup
. The name must be unique within an Amazon Web Services Region in an Amazon Web Services account. The name:
Must start and end with an alphanumeric character.
@@ -1496,8 +1496,8 @@ export interface CreateFeatureGroupRequest { /** *You can turn the OnlineStore
on or off by specifying True
for
* the EnableOnlineStore
flag in OnlineStoreConfig
.
You can also include an Amazon Web Services KMS key ID (KMSKeyId
) for at-rest encryption of
- * the OnlineStore
.
You can also include an Amazon Web Services KMS key ID (KMSKeyId
) for
+ * at-rest encryption of the OnlineStore
.
The default value is False
.
OfflineStore
.
* A configuration for an Amazon Web Services Glue or Amazon Web Services Hive data catalog.
+ *A configuration for an Amazon Web Services Glue or Amazon Web Services Hive data + * catalog.
*An KMS encryption key to encrypt the Amazon S3 location used for
- * OfflineStore
. If KMS encryption key is not specified, by default we encrypt all data at rest using
- * Amazon Web Services KMS key. By defining your bucket-level key for SSE,
- * you can reduce Amazon Web Services KMS requests costs by up to 99 percent.
OfflineStore
. If KMS encryption key is not specified, by default we
+ * encrypt all data at rest using Amazon Web Services KMS key. By defining your bucket-level
+ * key for SSE, you can reduce Amazon Web Services KMS requests costs by up to
+ * 99 percent.
* Format for the offline store table. Supported formats are Glue (Default) and Apache Iceberg.
+ *Format for the offline store table. Supported formats are Glue (Default) and + * Apache Iceberg.
*To learn more about this parameter, see OfflineStoreConfig.
@@ -10383,6 +10386,20 @@ export interface CreateWorkteamResponse { WorkteamArn?: string; } +/** + * @public + * @enum + */ +export const CrossAccountFilterOption = { + CROSS_ACCOUNT: "CrossAccount", + SAME_ACCOUNT: "SameAccount", +} as const; + +/** + * @public + */ +export type CrossAccountFilterOption = (typeof CrossAccountFilterOption)[keyof typeof CrossAccountFilterOption]; + /** * @public *The currently active data capture configuration used by your Endpoint.
@@ -10796,31 +10813,6 @@ export const HubContentType = { */ export type HubContentType = (typeof HubContentType)[keyof typeof HubContentType]; -/** - * @public - */ -export interface DeleteHubContentRequest { - /** - *The name of the hub that you want to delete content in.
- */ - HubName: string | undefined; - - /** - *The type of content that you want to delete from a hub.
- */ - HubContentType: HubContentType | string | undefined; - - /** - *The name of the content that you want to delete from a hub.
- */ - HubContentName: string | undefined; - - /** - *The version of the content that you want to delete from a hub.
- */ - HubContentVersion: string | undefined; -} - /** * @internal */ diff --git a/clients/client-sagemaker/src/models/models_2.ts b/clients/client-sagemaker/src/models/models_2.ts index 9b875e52008be..3ef66da1eb0c5 100644 --- a/clients/client-sagemaker/src/models/models_2.ts +++ b/clients/client-sagemaker/src/models/models_2.ts @@ -177,6 +177,31 @@ import { VendorGuidance, } from "./models_1"; +/** + * @public + */ +export interface DeleteHubContentRequest { + /** + *The name of the hub that you want to delete content in.
+ */ + HubName: string | undefined; + + /** + *The type of content that you want to delete from a hub.
+ */ + HubContentType: HubContentType | string | undefined; + + /** + *The name of the content that you want to delete from a hub.
+ */ + HubContentName: string | undefined; + + /** + *The version of the content that you want to delete from a hub.
+ */ + HubContentVersion: string | undefined; +} + /** * @public */ @@ -2793,7 +2818,8 @@ export interface DescribeExperimentResponse { */ export interface DescribeFeatureGroupRequest { /** - *The name of the FeatureGroup
you want described.
The name or Amazon Resource Name (ARN) of the FeatureGroup
you want
+ * described.
The Amazon Resource Name (ARN) of the FeatureGroup
.
The Amazon Resource Name (ARN) of the FeatureGroup
.
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
.
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 list of the Features
in the FeatureGroup
. Each feature is
+ * defined by a FeatureName
and FeatureType
.
Table format of the offline store.
*Option to disable the automatic creation of a Glue table for the offline store.
+ *Option to disable the automatic creation of a Glue table for the offline + * store.
*Encryption configuration.
@@ -2958,7 +2985,8 @@ export interface DescribeFeatureGroupResponse { OfflineStoreConfig?: OfflineStoreConfig; /** - *The Amazon Resource Name (ARN) of the IAM execution role used to persist data into the OfflineStore if an OfflineStoreConfig is provided.
+ *The Amazon Resource Name (ARN) of the IAM execution role used to persist data into the + * OfflineStore if an OfflineStoreConfig is provided.
*/ RoleArn?: string; @@ -3018,7 +3046,8 @@ export interface DescribeFeatureGroupResponse { */ export interface DescribeFeatureMetadataRequest { /** - *The name of the feature group containing the feature.
+ *The name or Amazon Resource Name (ARN) of the feature group containing the + * feature.
*/ FeatureGroupName: string | undefined; @@ -3074,7 +3103,9 @@ export interface DescribeFeatureMetadataResponse { 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
+ *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
*/ LastModifiedTime: Date | undefined; @@ -9484,10 +9515,10 @@ export interface FailStepMetadata { /** * @public - *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.
+ *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.
*/ export interface FeatureGroup { /** @@ -9502,18 +9533,18 @@ export interface FeatureGroup { /** *The name of the Feature
whose value uniquely identifies a
- * Record
defined in the FeatureGroup
+ * 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
.
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
.
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
.
To encrypt an OfflineStore
using at rest data encryption, specify Amazon Web Services Key Management Service (KMS) key ID, or KMSKeyId
, in
+ * S3StorageConfig
.
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
.
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
.
The name, Arn, CreationTime
, FeatureGroup
values,
+ *
The name, ARN, CreationTime
, FeatureGroup
values,
* LastUpdatedTime
and EnableOnlineStorage
status of a
* FeatureGroup
.
A timestamp indicating the time of creation time of the FeatureGroup
.
A timestamp indicating the time of creation time of the
+ * FeatureGroup
.
The metadata for a feature. It can either be metadata that you specify, or metadata that is updated automatically.
+ *The metadata for a feature. It can either be metadata that you specify, or metadata that + * is updated automatically.
*/ export interface FeatureMetadata { /** @@ -10085,16 +10117,6 @@ export const SagemakerServicecatalogStatus = { export type SagemakerServicecatalogStatus = (typeof SagemakerServicecatalogStatus)[keyof typeof SagemakerServicecatalogStatus]; -/** - * @public - */ -export interface GetSagemakerServicecatalogPortfolioStatusOutput { - /** - *Whether Service Catalog is enabled or disabled in SageMaker.
- */ - Status?: SagemakerServicecatalogStatus | string; -} - /** * @internal */ diff --git a/clients/client-sagemaker/src/models/models_3.ts b/clients/client-sagemaker/src/models/models_3.ts index 14cecfa2901f4..484446c039b50 100644 --- a/clients/client-sagemaker/src/models/models_3.ts +++ b/clients/client-sagemaker/src/models/models_3.ts @@ -5,7 +5,6 @@ import { ActionSummary, AdditionalInferenceSpecificationDefinition, AlgorithmSortBy, - AlgorithmSpecification, AlgorithmSummary, AppDetails, AppImageConfigDetails, @@ -26,8 +25,6 @@ import { CallbackStepMetadata, CandidateSortBy, CandidateStatus, - Channel, - CheckpointConfig, ClarifyCheckStepMetadata, CodeRepositorySortBy, CodeRepositorySortOrder, @@ -41,10 +38,7 @@ import { MetadataProperties, ModelApprovalStatus, ModelPackageStatus, - OutputDataConfig, OutputParameter, - ResourceConfig, - StoppingCondition, Tag, TransformInput, TransformOutput, @@ -55,9 +49,6 @@ import { import { _InstanceType, DataProcessing, - DebugHookConfig, - DebugRuleConfiguration, - DebugRuleEvaluationStatus, DriftCheckBaselines, ExperimentConfig, HubContentType, @@ -84,11 +75,9 @@ import { ProcessingStoppingCondition, RecommendationJobType, ResourceLimits, - RetryStrategy, ServiceCatalogProvisioningDetails, SourceAlgorithmSpecification, StudioLifecycleConfigAppType, - TensorBoardOutputConfig, TrialComponentStatus, TtlDuration, UiTemplate, @@ -134,8 +123,6 @@ import { LabelCounters, LabelingJobOutput, LabelingJobStatus, - MetricData, - ModelArtifacts, ModelCardExportJobStatus, ModelConfiguration, ModelPackageGroupStatus, @@ -151,9 +138,8 @@ import { ProjectStatus, RecommendationJobStatus, RecommendationMetrics, + SagemakerServicecatalogStatus, ScheduleStatus, - SecondaryStatus, - SecondaryStatusTransition, SelectiveExecutionConfig, ServiceCatalogProvisionedProductDetails, SpaceStatus, @@ -170,6 +156,16 @@ import { Workteam, } from "./models_2"; +/** + * @public + */ +export interface GetSagemakerServicecatalogPortfolioStatusOutput { + /** + *Whether Service Catalog is enabled or disabled in SageMaker.
+ */ + Status?: SagemakerServicecatalogStatus | string; +} + /** * @public * @enum @@ -2856,7 +2852,8 @@ export interface ListFeatureGroupsRequest { FeatureGroupStatusEquals?: FeatureGroupStatus | string; /** - *An OfflineStore
status. Filters by OfflineStore
status.
An OfflineStore
status. Filters by OfflineStore
status.
+ *
A string that partially matches one or more ResourceCatalog
s names.
+ * Filters ResourceCatalog
by name.
Use this parameter to search for ResourceCatalog
s created after a
+ * specific date and time.
Use this parameter to search for ResourceCatalog
s created before a
+ * specific date and time.
The order in which the resource catalogs are listed.
+ */ + SortOrder?: ResourceCatalogSortOrder | string; + + /** + *The value on which the resource catalog list is sorted.
+ */ + SortBy?: ResourceCatalogSortBy | string; + + /** + * The maximum number of results returned by ListResourceCatalogs
.
A token to resume pagination of ListResourceCatalogs
results.
A resource catalog containing all of the resources of a specific resource type within
+ * a resource owner account. For an example on sharing the Amazon SageMaker Feature Store
+ * DefaultFeatureGroupCatalog
, see Share Amazon SageMaker Catalog resource type in the Amazon SageMaker Developer Guide.
+ *
The Amazon Resource Name (ARN) of the ResourceCatalog
.
The name of the ResourceCatalog
.
A free form description of the ResourceCatalog
.
The time the ResourceCatalog
was created.
A list of the requested ResourceCatalog
s.
A token to resume pagination of ListResourceCatalogs
results.
The Amazon Resource Name (ARN) of the pipeline execution.
- */ - PipelineExecutionArn: string | undefined; - - /** - *A unique, case-sensitive identifier that you provide to ensure the idempotency of the - * operation. An idempotent operation completes no more than once.
- */ - ClientRequestToken?: string; - - /** - *This configuration, if specified, overrides the parallelism configuration - * of the parent pipeline.
- */ - ParallelismConfiguration?: ParallelismConfiguration; -} - -/** - * @public - */ -export interface RetryPipelineExecutionResponse { - /** - *The Amazon Resource Name (ARN) of the pipeline execution.
- */ - PipelineExecutionArn?: string; -} - -/** - * @public - * @enum - */ -export const SearchSortOrder = { - ASCENDING: "Ascending", - DESCENDING: "Descending", -} as const; - -/** - * @public - */ -export type SearchSortOrder = (typeof SearchSortOrder)[keyof typeof SearchSortOrder]; - -/** - * @public - *Contains information about a training job.
- */ -export interface TrainingJob { - /** - *The name of the training job.
- */ - TrainingJobName?: string; - - /** - *The Amazon Resource Name (ARN) of the training job.
- */ - TrainingJobArn?: string; - - /** - *The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the - * training job was launched by a hyperparameter tuning job.
- */ - TuningJobArn?: string; - - /** - *The Amazon Resource Name (ARN) of the labeling job.
- */ - LabelingJobArn?: string; - - /** - *The Amazon Resource Name (ARN) of the job.
- */ - AutoMLJobArn?: string; - - /** - *Information about the Amazon S3 location that is configured for storing model - * artifacts.
- */ - ModelArtifacts?: ModelArtifacts; - - /** - *The status of the - * training - * job.
- *Training job statuses are:
- *
- * 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 about 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.
- * 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.
Valid values for SecondaryStatus
are subject to change.
We no longer support the following secondary statuses:
- *
- * LaunchingMLInstances
- *
- * PreparingTrainingStack
- *
- * DownloadingTrainingImage
- *
If the training job failed, the reason it failed.
- */ - FailureReason?: string; - - /** - *Algorithm-specific parameters.
- */ - HyperParameters?: RecordInformation about the algorithm used for training, and algorithm metadata.
- */ - AlgorithmSpecification?: AlgorithmSpecification; - - /** - *The Amazon Web Services Identity and Access Management (IAM) role configured for the - * training job.
- */ - RoleArn?: string; - - /** - *An array of Channel
objects that describes each data input
- * channel.
Your input must be in the same Amazon Web Services region as your training job.
- */ - InputDataConfig?: Channel[]; - - /** - *The S3 path where model artifacts that you configured when creating the job are - * stored. SageMaker creates subfolders for model artifacts.
- */ - OutputDataConfig?: OutputDataConfig; - - /** - *Resources, including ML compute instances and ML storage volumes, that are configured - * for model training.
- */ - ResourceConfig?: ResourceConfig; - - /** - *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.
- */ - VpcConfig?: VpcConfig; - - /** - *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.
- */ - CreationTime?: Date; - - /** - *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.
- */ - LastModifiedTime?: Date; - - /** - *A history of all of the secondary statuses that the training job has transitioned - * through.
- */ - SecondaryStatusTransitions?: SecondaryStatusTransition[]; - - /** - *A list of final metric values that are set when the training job completes. Used only - * if the training job was configured to use metrics.
- */ - FinalMetricDataList?: MetricData[]; - - /** - *If the TrainingJob
was created with network isolation, the value is set
- * to true
. If network isolation is enabled, nodes can't communicate beyond
- * the VPC they run in.
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 algorithm in
- * distributed training.
When true, enables managed spot training using Amazon EC2 Spot instances to run - * training jobs instead of on-demand instances. For more information, see Managed Spot Training.
- */ - EnableManagedSpotTraining?: boolean; - - /** - *Contains information about the output location for managed spot training checkpoint - * data.
- */ - CheckpointConfig?: CheckpointConfig; - - /** - *The training time in seconds.
- */ - TrainingTimeInSeconds?: number; - - /** - *The billable time in seconds.
- */ - BillableTimeInSeconds?: number; - - /** - *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:
- *- * CreateProcessingJob - *
- *- * CreateTrainingJob - *
- *- * CreateTransformJob - *
- *Information about the debug rule configuration.
- */ - DebugRuleConfigurations?: DebugRuleConfiguration[]; - - /** - *Configuration of storage locations for the Amazon SageMaker Debugger TensorBoard output data.
- */ - TensorBoardOutputConfig?: TensorBoardOutputConfig; - - /** - *Information about the evaluation status of the rules for the training job.
- */ - DebugRuleEvaluationStatuses?: DebugRuleEvaluationStatus[]; - - /** - *The environment variables to set in the Docker container.
- */ - Environment?: RecordThe number of times to retry the job when the job fails due to an
- * InternalServerError
.
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.
- */ - Tags?: Tag[]; -} - -/** - * @public - *A short summary of a trial component.
- */ -export interface TrialComponentSimpleSummary { - /** - *The name of the trial component.
- */ - TrialComponentName?: string; - - /** - *The Amazon Resource Name (ARN) of the trial component.
- */ - TrialComponentArn?: string; - - /** - *The Amazon Resource Name (ARN) and job type of the source of a trial component.
- */ - TrialComponentSource?: TrialComponentSource; - - /** - *When the component was created.
- */ - CreationTime?: Date; - - /** - *Information about the user who created or modified an experiment, trial, trial - * component, lineage group, project, or model card.
- */ - CreatedBy?: UserContext; -} - -/** - * @public - *The properties of a trial as returned by the Search API.
- */ -export interface Trial { - /** - *The name of the trial.
- */ - TrialName?: string; - - /** - *The Amazon Resource Name (ARN) of the trial.
- */ - TrialArn?: string; - - /** - *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.
- */ - ExperimentName?: string; - - /** - *The source of the trial.
- */ - Source?: TrialSource; - - /** - *When the trial was created.
- */ - CreationTime?: Date; - - /** - *Who created the trial.
- */ - CreatedBy?: UserContext; - - /** - *Who last modified the trial.
- */ - LastModifiedTime?: Date; - - /** - *Information about the user who created or modified an experiment, trial, trial - * component, lineage group, project, or model card.
- */ - LastModifiedBy?: UserContext; - - /** - *Metadata properties of the tracking entity, trial, or trial component.
- */ - MetadataProperties?: MetadataProperties; - - /** - *The list of tags that are associated with the trial. You can use Search - * API to search on the tags.
- */ - Tags?: Tag[]; - - /** - *A list of the components associated with the trial. For each component, a summary of the - * component's properties is included.
- */ - TrialComponentSummaries?: TrialComponentSimpleSummary[]; -} - /** * @internal */ diff --git a/clients/client-sagemaker/src/models/models_4.ts b/clients/client-sagemaker/src/models/models_4.ts index e55980a6c9352..fcfdbfade1656 100644 --- a/clients/client-sagemaker/src/models/models_4.ts +++ b/clients/client-sagemaker/src/models/models_4.ts @@ -4,20 +4,32 @@ import { SENSITIVE_STRING } from "@smithy/smithy-client"; import { ActionStatus, AdditionalInferenceSpecificationDefinition, + AlgorithmSpecification, AppSecurityGroupManagement, BooleanOperator, + Channel, + CheckpointConfig, DefaultSpaceSettings, EdgeOutputConfig, KernelGatewayImageConfig, MetadataProperties, ModelApprovalStatus, + OutputDataConfig, OutputParameter, + ResourceConfig, + StoppingCondition, Tag, UserContext, + VpcConfig, } from "./models_0"; import { _InstanceType, + CrossAccountFilterOption, + DebugHookConfig, + DebugRuleConfiguration, + DebugRuleEvaluationStatus, DeploymentConfig, + ExperimentConfig, FeatureDefinition, InferenceExperimentDataStorageConfig, InferenceExperimentSchedule, @@ -37,10 +49,12 @@ import { Processor, ProfilerRuleConfiguration, ProvisioningParameter, + RetryStrategy, RootAccess, ShadowModeConfig, SourceIpConfig, SpaceSettings, + TensorBoardOutputConfig, TrialComponentArtifact, TrialComponentParameterValue, TrialComponentStatus, @@ -58,9 +72,15 @@ import { FeatureMetadata, FeatureParameter, Filter, + MetricData, + ModelArtifacts, + SecondaryStatus, + SecondaryStatusTransition, SelectiveExecutionConfig, + TrainingJobStatus, TrialComponentMetricSummary, TrialComponentSource, + TrialSource, Workforce, Workteam, } from "./models_2"; @@ -85,12 +105,527 @@ import { Project, ResourceConfigForUpdate, ResourceType, - SearchSortOrder, - TrainingJob, TransformJob, - Trial, } from "./models_3"; +/** + * @public + */ +export interface RetryPipelineExecutionRequest { + /** + *The Amazon Resource Name (ARN) of the pipeline execution.
+ */ + PipelineExecutionArn: string | undefined; + + /** + *A unique, case-sensitive identifier that you provide to ensure the idempotency of the + * operation. An idempotent operation completes no more than once.
+ */ + ClientRequestToken?: string; + + /** + *This configuration, if specified, overrides the parallelism configuration + * of the parent pipeline.
+ */ + ParallelismConfiguration?: ParallelismConfiguration; +} + +/** + * @public + */ +export interface RetryPipelineExecutionResponse { + /** + *The Amazon Resource Name (ARN) of the pipeline execution.
+ */ + PipelineExecutionArn?: string; +} + +/** + * @public + * @enum + */ +export const SearchSortOrder = { + ASCENDING: "Ascending", + DESCENDING: "Descending", +} as const; + +/** + * @public + */ +export type SearchSortOrder = (typeof SearchSortOrder)[keyof typeof SearchSortOrder]; + +/** + * @public + *Contains information about a training job.
+ */ +export interface TrainingJob { + /** + *The name of the training job.
+ */ + TrainingJobName?: string; + + /** + *The Amazon Resource Name (ARN) of the training job.
+ */ + TrainingJobArn?: string; + + /** + *The Amazon Resource Name (ARN) of the associated hyperparameter tuning job if the + * training job was launched by a hyperparameter tuning job.
+ */ + TuningJobArn?: string; + + /** + *The Amazon Resource Name (ARN) of the labeling job.
+ */ + LabelingJobArn?: string; + + /** + *The Amazon Resource Name (ARN) of the job.
+ */ + AutoMLJobArn?: string; + + /** + *Information about the Amazon S3 location that is configured for storing model + * artifacts.
+ */ + ModelArtifacts?: ModelArtifacts; + + /** + *The status of the + * training + * job.
+ *Training job statuses are:
+ *
+ * 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 about 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.
+ * 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.
Valid values for SecondaryStatus
are subject to change.
We no longer support the following secondary statuses:
+ *
+ * LaunchingMLInstances
+ *
+ * PreparingTrainingStack
+ *
+ * DownloadingTrainingImage
+ *
If the training job failed, the reason it failed.
+ */ + FailureReason?: string; + + /** + *Algorithm-specific parameters.
+ */ + HyperParameters?: RecordInformation about the algorithm used for training, and algorithm metadata.
+ */ + AlgorithmSpecification?: AlgorithmSpecification; + + /** + *The Amazon Web Services Identity and Access Management (IAM) role configured for the + * training job.
+ */ + RoleArn?: string; + + /** + *An array of Channel
objects that describes each data input
+ * channel.
Your input must be in the same Amazon Web Services region as your training job.
+ */ + InputDataConfig?: Channel[]; + + /** + *The S3 path where model artifacts that you configured when creating the job are + * stored. SageMaker creates subfolders for model artifacts.
+ */ + OutputDataConfig?: OutputDataConfig; + + /** + *Resources, including ML compute instances and ML storage volumes, that are configured + * for model training.
+ */ + ResourceConfig?: ResourceConfig; + + /** + *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.
+ */ + VpcConfig?: VpcConfig; + + /** + *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.
+ */ + CreationTime?: Date; + + /** + *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.
+ */ + LastModifiedTime?: Date; + + /** + *A history of all of the secondary statuses that the training job has transitioned + * through.
+ */ + SecondaryStatusTransitions?: SecondaryStatusTransition[]; + + /** + *A list of final metric values that are set when the training job completes. Used only + * if the training job was configured to use metrics.
+ */ + FinalMetricDataList?: MetricData[]; + + /** + *If the TrainingJob
was created with network isolation, the value is set
+ * to true
. If network isolation is enabled, nodes can't communicate beyond
+ * the VPC they run in.
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 algorithm in
+ * distributed training.
When true, enables managed spot training using Amazon EC2 Spot instances to run + * training jobs instead of on-demand instances. For more information, see Managed Spot Training.
+ */ + EnableManagedSpotTraining?: boolean; + + /** + *Contains information about the output location for managed spot training checkpoint + * data.
+ */ + CheckpointConfig?: CheckpointConfig; + + /** + *The training time in seconds.
+ */ + TrainingTimeInSeconds?: number; + + /** + *The billable time in seconds.
+ */ + BillableTimeInSeconds?: number; + + /** + *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:
+ *+ * CreateProcessingJob + *
+ *+ * CreateTrainingJob + *
+ *+ * CreateTransformJob + *
+ *Information about the debug rule configuration.
+ */ + DebugRuleConfigurations?: DebugRuleConfiguration[]; + + /** + *Configuration of storage locations for the Amazon SageMaker Debugger TensorBoard output data.
+ */ + TensorBoardOutputConfig?: TensorBoardOutputConfig; + + /** + *Information about the evaluation status of the rules for the training job.
+ */ + DebugRuleEvaluationStatuses?: DebugRuleEvaluationStatus[]; + + /** + *The environment variables to set in the Docker container.
+ */ + Environment?: RecordThe number of times to retry the job when the job fails due to an
+ * InternalServerError
.
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.
+ */ + Tags?: Tag[]; +} + +/** + * @public + *A short summary of a trial component.
+ */ +export interface TrialComponentSimpleSummary { + /** + *The name of the trial component.
+ */ + TrialComponentName?: string; + + /** + *The Amazon Resource Name (ARN) of the trial component.
+ */ + TrialComponentArn?: string; + + /** + *The Amazon Resource Name (ARN) and job type of the source of a trial component.
+ */ + TrialComponentSource?: TrialComponentSource; + + /** + *When the component was created.
+ */ + CreationTime?: Date; + + /** + *Information about the user who created or modified an experiment, trial, trial + * component, lineage group, project, or model card.
+ */ + CreatedBy?: UserContext; +} + +/** + * @public + *The properties of a trial as returned by the Search API.
+ */ +export interface Trial { + /** + *The name of the trial.
+ */ + TrialName?: string; + + /** + *The Amazon Resource Name (ARN) of the trial.
+ */ + TrialArn?: string; + + /** + *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.
+ */ + ExperimentName?: string; + + /** + *The source of the trial.
+ */ + Source?: TrialSource; + + /** + *When the trial was created.
+ */ + CreationTime?: Date; + + /** + *Who created the trial.
+ */ + CreatedBy?: UserContext; + + /** + *Who last modified the trial.
+ */ + LastModifiedTime?: Date; + + /** + *Information about the user who created or modified an experiment, trial, trial + * component, lineage group, project, or model card.
+ */ + LastModifiedBy?: UserContext; + + /** + *Metadata properties of the tracking entity, trial, or trial component.
+ */ + MetadataProperties?: MetadataProperties; + + /** + *The list of tags that are associated with the trial. You can use Search + * API to search on the tags.
+ */ + Tags?: Tag[]; + + /** + *A list of the components associated with the trial. For each component, a summary of the + * component's properties is included.
+ */ + TrialComponentSummaries?: TrialComponentSimpleSummary[]; +} + /** * @public *Detailed information about the source of a trial component. Either @@ -284,10 +819,10 @@ export interface SearchRecord { PipelineExecution?: PipelineExecution; /** - *
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.
+ *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.
*/ FeatureGroup?: FeatureGroup; @@ -1154,7 +1689,7 @@ export interface UpdateExperimentResponse { */ export interface UpdateFeatureGroupRequest { /** - *The name of the feature group that you're updating.
+ *The name or Amazon Resource Name (ARN) of the feature group that you're updating.
*/ FeatureGroupName: string | undefined; @@ -1186,7 +1721,8 @@ export interface UpdateFeatureGroupResponse { */ export interface UpdateFeatureMetadataRequest { /** - *The name of the feature group containing the feature that you're updating.
+ *The name or Amazon Resource Name (ARN) of the feature group containing the feature that + * you're updating.
*/ FeatureGroupName: string | undefined; @@ -1206,7 +1742,8 @@ export interface UpdateFeatureMetadataRequest { ParameterAdditions?: FeatureParameter[]; /** - *A list of parameter keys that you can specify to remove parameters that describe your feature.
+ *A list of parameter keys that you can specify to remove parameters that describe your + * feature.
*/ ParameterRemovals?: string[]; } @@ -2315,6 +2852,20 @@ export interface SearchRequest { *The maximum number of results to return.
*/ MaxResults?: number; + + /** + *
+ * A cross account filter option. When the value is "CrossAccount"
the
+ * search results will only include resources made discoverable to you from other
+ * accounts. When the value is "SameAccount"
or null
the
+ * search results will only include resources from your account. Default is
+ * null
. For more information on searching for resources made
+ * discoverable to your account, see
+ * Search discoverable resources in the SageMaker Developer Guide.
+ * The maximum number of ResourceCatalog
s viewable is 1000.
+ *
Create a new FeatureGroup
. A FeatureGroup
is a group of\n Features
defined in the FeatureStore
to describe a\n Record
.
The FeatureGroup
defines the schema and features contained in the\n FeatureGroup. A FeatureGroup
definition is composed of a list of\n Features
, a RecordIdentifierFeatureName
, an\n EventTimeFeatureName
and configurations for its OnlineStore
\n and OfflineStore
. Check Amazon Web Services service quotas to see\n the FeatureGroup
s quota for your Amazon Web Services account.
You must include at least one of OnlineStoreConfig
and\n OfflineStoreConfig
to create a FeatureGroup
.
Create a new FeatureGroup
. A FeatureGroup
is a group of\n Features
defined in the FeatureStore
to describe a\n Record
.
The FeatureGroup
defines the schema and features contained in the\n FeatureGroup. A FeatureGroup
definition is composed of a list of\n Features
, a RecordIdentifierFeatureName
, an\n EventTimeFeatureName
and configurations for its OnlineStore
\n and OfflineStore
. Check Amazon Web Services service\n quotas to see the FeatureGroup
s quota for your Amazon Web Services\n account.
You must include at least one of OnlineStoreConfig
and\n OfflineStoreConfig
to create a FeatureGroup
.
The name of the FeatureGroup
. The name must be unique within an Amazon Web Services Region\n in an Amazon Web Services account. The name:
Must start and end with an alphanumeric character.
\nCan only contain alphanumeric character and hyphens. Spaces are not allowed.\n
\nThe name of the FeatureGroup
. The name must be unique within an Amazon Web Services Region in an Amazon Web Services account. The name:
Must start and end with an alphanumeric character.
\nCan only contain alphanumeric character and hyphens. Spaces are not allowed.\n
\nYou can turn the OnlineStore
on or off by specifying True
for\n the EnableOnlineStore
flag in OnlineStoreConfig
.
You can also include an Amazon Web Services KMS key ID (KMSKeyId
) for at-rest encryption of\n the OnlineStore
.
The default value is False
.
You can turn the OnlineStore
on or off by specifying True
for\n the EnableOnlineStore
flag in OnlineStoreConfig
.
You can also include an Amazon Web Services KMS key ID (KMSKeyId
) for\n at-rest encryption of the OnlineStore
.
The default value is False
.
Use this to configure an OfflineFeatureStore
. This parameter allows you to\n specify:
The Amazon Simple Storage Service (Amazon S3) location of an\n OfflineStore
.
A configuration for an Amazon Web Services Glue or Amazon Web Services Hive data catalog.
\nAn KMS encryption key to encrypt the Amazon S3 location used for\n OfflineStore
. If KMS encryption key is not specified, by default we encrypt all data at rest using \n Amazon Web Services KMS key. By defining your bucket-level key for SSE, \n you can reduce Amazon Web Services KMS requests costs by up to 99 percent.
Format for the offline store table. Supported formats are Glue (Default) and Apache Iceberg.
\nTo learn more about this parameter, see OfflineStoreConfig.
" + "smithy.api#documentation": "Use this to configure an OfflineFeatureStore
. This parameter allows you to\n specify:
The Amazon Simple Storage Service (Amazon S3) location of an\n OfflineStore
.
A configuration for an Amazon Web Services Glue or Amazon Web Services Hive data\n catalog.
\nAn KMS encryption key to encrypt the Amazon S3 location used for\n OfflineStore
. If KMS encryption key is not specified, by default we\n encrypt all data at rest using Amazon Web Services KMS key. By defining your bucket-level\n key for SSE, you can reduce Amazon Web Services KMS requests costs by up to\n 99 percent.
Format for the offline store table. Supported formats are Glue (Default) and\n Apache Iceberg.
\nTo learn more about this parameter, see OfflineStoreConfig.
" } }, "RoleArn": { @@ -11176,6 +11176,23 @@ "com.amazonaws.sagemaker#CreationTime": { "type": "timestamp" }, + "com.amazonaws.sagemaker#CrossAccountFilterOption": { + "type": "enum", + "members": { + "SAME_ACCOUNT": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "SameAccount" + } + }, + "CROSS_ACCOUNT": { + "target": "smithy.api#Unit", + "traits": { + "smithy.api#enumValue": "CrossAccount" + } + } + } + }, "com.amazonaws.sagemaker#CsvContentType": { "type": "string", "traits": { @@ -12438,7 +12455,7 @@ } ], "traits": { - "smithy.api#documentation": "Delete the FeatureGroup
and any data that was written to the\n OnlineStore
of the FeatureGroup
. Data cannot be accessed from\n the OnlineStore
immediately after DeleteFeatureGroup
is called.
Data written into the OfflineStore
will not be deleted. The Amazon Web Services Glue\n database and tables that are automatically created for your OfflineStore
are\n not deleted.
Delete the FeatureGroup
and any data that was written to the\n OnlineStore
of the FeatureGroup
. Data cannot be accessed from\n the OnlineStore
immediately after DeleteFeatureGroup
is called.
Data written into the OfflineStore
will not be deleted. The Amazon Web Services Glue database and tables that are automatically created for your\n OfflineStore
are not deleted.
The name of the FeatureGroup
you want described.
The name or Amazon Resource Name (ARN) of the FeatureGroup
you want\n described.
The Amazon Resource Name (ARN) of the FeatureGroup
.
The Amazon Resource Name (ARN) of the FeatureGroup
.
The name of the feature that stores the EventTime
of a Record in a\n FeatureGroup
.
An EventTime
is a point in time when a new event occurs that\n corresponds to the creation or update of a Record
in a\n FeatureGroup
. All Records
in the FeatureGroup
\n have a corresponding EventTime
.
The name of the feature that stores the EventTime
of a Record in a\n FeatureGroup
.
An EventTime
is a point in time when a new event occurs that corresponds\n to the creation or update of a Record
in a FeatureGroup
. All\n Records
in the FeatureGroup
have a corresponding\n EventTime
.
A list of the Features
in the FeatureGroup
. \n Each feature is defined by a FeatureName
and FeatureType
.
A list of the Features
in the FeatureGroup
. Each feature is\n defined by a FeatureName
and FeatureType
.
The configuration of the offline store. It includes the following configurations:
\nAmazon S3 location of the offline store.
\nConfiguration of the Glue data catalog.
\nTable format of the offline store.
\nOption to disable the automatic creation of a Glue table for the offline store.
\nEncryption configuration.
\nThe configuration of the offline store. It includes the following configurations:
\nAmazon S3 location of the offline store.
\nConfiguration of the Glue data catalog.
\nTable format of the offline store.
\nOption to disable the automatic creation of a Glue table for the offline\n store.
\nEncryption configuration.
\nThe Amazon Resource Name (ARN) of the IAM execution role used to persist data into the OfflineStore if an OfflineStoreConfig is provided.
" + "smithy.api#documentation": "The Amazon Resource Name (ARN) of the IAM execution role used to persist data into the\n OfflineStore if an OfflineStoreConfig is provided.
" } }, "FeatureGroupStatus": { @@ -16236,9 +16253,9 @@ "type": "structure", "members": { "FeatureGroupName": { - "target": "com.amazonaws.sagemaker#FeatureGroupName", + "target": "com.amazonaws.sagemaker#FeatureGroupNameOrArn", "traits": { - "smithy.api#documentation": "The name of the feature group containing the feature.
", + "smithy.api#documentation": "The name or Amazon Resource Name (ARN) of the feature group containing the\n feature.
", "smithy.api#required": {} } }, @@ -16295,7 +16312,7 @@ "LastModifiedTime": { "target": "com.amazonaws.sagemaker#LastModifiedTime", "traits": { - "smithy.api#documentation": "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
", + "smithy.api#documentation": "A timestamp indicating when the metadata for the feature group was modified. For\n example, if you add a parameter describing the feature, the timestamp changes to reflect\n the last time you
", "smithy.api#required": {} } }, @@ -23730,13 +23747,13 @@ "RecordIdentifierFeatureName": { "target": "com.amazonaws.sagemaker#FeatureName", "traits": { - "smithy.api#documentation": "The name of the Feature
whose value uniquely identifies a\n Record
defined in the FeatureGroup
\n FeatureDefinitions
.
The name of the Feature
whose value uniquely identifies a\n Record
defined in the FeatureGroup
\n FeatureDefinitions
.
The name of the feature that stores the EventTime
of a Record in a\n FeatureGroup
.
A EventTime
is point in time when a new event\n occurs that corresponds to the creation or update of a Record
in\n FeatureGroup
. All Records
in the FeatureGroup
\n must have a corresponding EventTime
.
The name of the feature that stores the EventTime
of a Record in a\n FeatureGroup
.
A EventTime
is point in time when a new event occurs that corresponds to\n the creation or update of a Record
in FeatureGroup
. All\n Records
in the FeatureGroup
must have a corresponding\n EventTime
.
The reason that the FeatureGroup
failed to \n be replicated in the OfflineStore
. This is \n failure may be due to a failure to create a FeatureGroup
in\n or delete a FeatureGroup
from the OfflineStore
.
The reason that the FeatureGroup
failed to be replicated in the\n OfflineStore
. This is failure may be due to a failure to create a\n FeatureGroup
in or delete a FeatureGroup
from the\n OfflineStore
.
Amazon SageMaker Feature Store stores features in a collection called Feature Group. \n A Feature Group can be visualized as a table which has rows, \n with a unique identifier for each row where each column in the table is a feature. \n In principle, a Feature Group is composed of features and values per features.
" + "smithy.api#documentation": "Amazon SageMaker Feature Store stores features in a collection called Feature Group. A\n Feature Group can be visualized as a table which has rows, with a unique identifier for\n each row where each column in the table is a feature. In principle, a Feature Group is\n composed of features and values per features.
" } }, "com.amazonaws.sagemaker#FeatureGroupArn": { @@ -23845,6 +23862,16 @@ } } }, + "com.amazonaws.sagemaker#FeatureGroupNameOrArn": { + "type": "string", + "traits": { + "smithy.api#length": { + "min": 1, + "max": 256 + }, + "smithy.api#pattern": "^(arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:feature-group\\/)?([a-zA-Z0-9]([_-]*[a-zA-Z0-9]){0,63})$" + } + }, "com.amazonaws.sagemaker#FeatureGroupSortBy": { "type": "enum", "members": { @@ -23952,7 +23979,7 @@ "CreationTime": { "target": "com.amazonaws.sagemaker#Timestamp", "traits": { - "smithy.api#documentation": "A timestamp indicating the time of creation time of the FeatureGroup
.
A timestamp indicating the time of creation time of the\n FeatureGroup
.
The name, Arn, CreationTime
, FeatureGroup
values,\n LastUpdatedTime
and EnableOnlineStorage
status of a\n FeatureGroup
.
The name, ARN, CreationTime
, FeatureGroup
values,\n LastUpdatedTime
and EnableOnlineStorage
status of a\n FeatureGroup
.
The metadata for a feature. It can either be metadata that you specify, or metadata that is updated automatically.
" + "smithy.api#documentation": "The metadata for a feature. It can either be metadata that you specify, or metadata that\n is updated automatically.
" } }, "com.amazonaws.sagemaker#FeatureName": { @@ -32023,7 +32050,7 @@ "OfflineStoreStatusEquals": { "target": "com.amazonaws.sagemaker#OfflineStoreStatusValue", "traits": { - "smithy.api#documentation": "An OfflineStore
status. Filters by OfflineStore
status.
An OfflineStore
status. Filters by OfflineStore
status.\n
Lists Amazon SageMaker Catalogs based on given filters and orders. The maximum number of\n ResourceCatalog
s viewable is 1000.
A string that partially matches one or more ResourceCatalog
s names.\n Filters ResourceCatalog
by name.
Use this parameter to search for ResourceCatalog
s created after a\n specific date and time.
Use this parameter to search for ResourceCatalog
s created before a\n specific date and time.
The order in which the resource catalogs are listed.
" + } + }, + "SortBy": { + "target": "com.amazonaws.sagemaker#ResourceCatalogSortBy", + "traits": { + "smithy.api#documentation": "The value on which the resource catalog list is sorted.
" + } + }, + "MaxResults": { + "target": "com.amazonaws.sagemaker#MaxResults", + "traits": { + "smithy.api#documentation": " The maximum number of results returned by ListResourceCatalogs
.
A token to resume pagination of ListResourceCatalogs
results.
A list of the requested ResourceCatalog
s.
A token to resume pagination of ListResourceCatalogs
results.
Set to True
to disable the automatic creation of an Amazon Web Services Glue table when\n configuring an OfflineStore
. If set to False
, Feature Store will name the \n OfflineStore
Glue table following \n Athena's naming recommendations.
The default value is False
.
Set to True
to disable the automatic creation of an Amazon Web Services Glue\n table when configuring an OfflineStore
. If set to False
, Feature\n Store will name the OfflineStore
Glue table following Athena's\n naming recommendations.
The default value is False
.
The configuration of an OfflineStore
.
Provide an OfflineStoreConfig
in a request to\n CreateFeatureGroup
to create an OfflineStore
.
To encrypt an OfflineStore
using at rest data encryption, specify Amazon Web Services Key\n Management Service (KMS) key ID, or KMSKeyId
, in\n S3StorageConfig
.
The configuration of an OfflineStore
.
Provide an OfflineStoreConfig
in a request to\n 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\n S3StorageConfig
.
Turn OnlineStore
off by specifying False
\n for the EnableOnlineStore
flag. Turn OnlineStore
\n on by specifying True
\n for the EnableOnlineStore
flag.
The default value is False
.
Turn OnlineStore
off by specifying False
for the\n EnableOnlineStore
flag. Turn OnlineStore
on by specifying\n True
for the EnableOnlineStore
flag.
The default value is False
.
The Amazon Web Services Key Management Service (KMS) key ARN that SageMaker Feature Store uses\n to encrypt the Amazon S3 objects at rest using Amazon S3 server-side encryption.
\nThe caller (either user or IAM role) of CreateFeatureGroup
must have\n below permissions to the OnlineStore
\n KmsKeyId
:
\n \"kms:Encrypt\"
\n
\n \"kms:Decrypt\"
\n
\n \"kms:DescribeKey\"
\n
\n \"kms:CreateGrant\"
\n
\n \"kms:RetireGrant\"
\n
\n \"kms:ReEncryptFrom\"
\n
\n \"kms:ReEncryptTo\"
\n
\n \"kms:GenerateDataKey\"
\n
\n \"kms:ListAliases\"
\n
\n \"kms:ListGrants\"
\n
\n \"kms:RevokeGrant\"
\n
The caller (either user or IAM role) to all DataPlane operations\n (PutRecord
, GetRecord
, DeleteRecord
) must have\n the following permissions to the KmsKeyId
:
\n \"kms:Decrypt\"
\n
The Amazon Web Services Key Management Service (KMS) key ARN that SageMaker Feature Store\n uses to encrypt the Amazon S3 objects at rest using Amazon S3 server-side\n encryption.
\nThe caller (either user or IAM role) of CreateFeatureGroup
must have below\n permissions to the OnlineStore
\n KmsKeyId
:
\n \"kms:Encrypt\"
\n
\n \"kms:Decrypt\"
\n
\n \"kms:DescribeKey\"
\n
\n \"kms:CreateGrant\"
\n
\n \"kms:RetireGrant\"
\n
\n \"kms:ReEncryptFrom\"
\n
\n \"kms:ReEncryptTo\"
\n
\n \"kms:GenerateDataKey\"
\n
\n \"kms:ListAliases\"
\n
\n \"kms:ListGrants\"
\n
\n \"kms:RevokeGrant\"
\n
The caller (either user or IAM role) to all DataPlane operations\n (PutRecord
, GetRecord
, DeleteRecord
) must have the\n following permissions to the KmsKeyId
:
\n \"kms:Decrypt\"
\n
The Amazon Resource Name (ARN) of the ResourceCatalog
.
The name of the ResourceCatalog
.
A free form description of the ResourceCatalog
.
The time the ResourceCatalog
was created.
A resource catalog containing all of the resources of a specific resource type within\n a resource owner account. For an example on sharing the Amazon SageMaker Feature Store\n DefaultFeatureGroupCatalog
, see Share Amazon SageMaker Catalog resource type in the Amazon SageMaker Developer Guide.\n
The S3 URI, or location in Amazon S3, of OfflineStore
.
S3 URIs have a format similar to the following: s3://example-bucket/prefix/
.
The S3 URI, or location in Amazon S3, of OfflineStore
.
S3 URIs have a format similar to the following:\n s3://example-bucket/prefix/
.
The Amazon Web Services Key Management Service (KMS) key ARN of the key used to encrypt any objects\n written into the OfflineStore
S3 location.
The IAM roleARN
that is passed as a parameter to\n CreateFeatureGroup
must have below permissions to the\n KmsKeyId
:
\n \"kms:GenerateDataKey\"
\n
The Amazon Web Services Key Management Service (KMS) key ARN of the key used to encrypt\n any objects written into the OfflineStore
S3 location.
The IAM roleARN
that is passed as a parameter to\n CreateFeatureGroup
must have below permissions to the\n KmsKeyId
:
\n \"kms:GenerateDataKey\"
\n
The Amazon Simple Storage (Amazon S3) location and and security configuration for OfflineStore
.
The Amazon Simple Storage (Amazon S3) location and and security configuration for\n OfflineStore
.
The maximum number of results to return.
" } + }, + "CrossAccountFilterOption": { + "target": "com.amazonaws.sagemaker#CrossAccountFilterOption", + "traits": { + "smithy.api#documentation": "\n A cross account filter option. When the value is \"CrossAccount\"
the \n search results will only include resources made discoverable to you from other \n accounts. When the value is \"SameAccount\"
or null
the \n search results will only include resources from your account. Default is \n null
. For more information on searching for resources made \n discoverable to your account, see \n Search discoverable resources in the SageMaker Developer Guide.\n The maximum number of ResourceCatalog
s viewable is 1000.\n
Updates the feature group.
" + "smithy.api#documentation": "Updates the feature group by either adding features or updating the online store\n configuration. Use one of the following request parameters at a time while using the\n UpdateFeatureGroup
API.
You can add features for your feature group using the FeatureAdditions
\n request parameter. Features cannot be removed from a feature group.
You can update the online store configuration by using the\n OnlineStoreConfig
request parameter. If a TtlDuration
is\n specified, the default TtlDuration
applies for all records added to the\n feature group after the feature group is updated. If a record level\n TtlDuration
exists from using the PutRecord
API, the record\n level TtlDuration
applies to that record instead of the default\n TtlDuration
.
The name of the feature group that you're updating.
", + "smithy.api#documentation": "The name or Amazon Resource Name (ARN) of the feature group that you're updating.
", "smithy.api#required": {} } }, @@ -57277,9 +57499,9 @@ "type": "structure", "members": { "FeatureGroupName": { - "target": "com.amazonaws.sagemaker#FeatureGroupName", + "target": "com.amazonaws.sagemaker#FeatureGroupNameOrArn", "traits": { - "smithy.api#documentation": "The name of the feature group containing the feature that you're updating.
", + "smithy.api#documentation": "The name or Amazon Resource Name (ARN) of the feature group containing the feature that \n you're updating.
", "smithy.api#required": {} } }, @@ -57305,7 +57527,7 @@ "ParameterRemovals": { "target": "com.amazonaws.sagemaker#FeatureParameterRemovals", "traits": { - "smithy.api#documentation": "A list of parameter keys that you can specify to remove parameters that describe your feature.
" + "smithy.api#documentation": "A list of parameter keys that you can specify to remove parameters that describe your\n feature.
" } } },