diff --git a/codegen/sdk-codegen/aws-models/cloudwatch.json b/codegen/sdk-codegen/aws-models/cloudwatch.json index f7d974be62b..c1fa0f501f6 100644 --- a/codegen/sdk-codegen/aws-models/cloudwatch.json +++ b/codegen/sdk-codegen/aws-models/cloudwatch.json @@ -851,7 +851,7 @@ } ], "traits": { - "smithy.api#documentation": "
Deletes the specified anomaly detection model from your account.
" + "smithy.api#documentation": "\n\t\t\tDeletes the specified anomaly detection model \n\t\t\tfrom your account.\n\t\t\tFor more information \n\t\t\tabout \n\t\t\thow to delete an anomaly detection model, \n\t\t\tsee Deleting an anomaly detection model \n\t\t\tin the CloudWatch User Guide. \n\t\t
" } }, "com.amazonaws.cloudwatch#DeleteAnomalyDetectorInput": { @@ -1492,7 +1492,7 @@ } }, "traits": { - "smithy.api#documentation": "A dimension is a name/value pair that is part of the identity of a metric. Because dimensions are part of the unique \n\t\t\tidentifier for a metric, whenever you add a unique name/value pair to one of \n\t\t\tyour metrics, you are creating a new variation of that metric. For example, many Amazon EC2 metrics publish\n\t\tInstanceId
as a dimension name, and the actual instance ID as the value for that dimension.
You \n\t\tcan assign up to 10 dimensions to a metric.
" + "smithy.api#documentation": "A dimension is a name/value pair that is part of the identity of a metric. Because dimensions are part of the unique \n\t\t\tidentifier for a metric, whenever you add a unique name/value pair to one of \n\t\t\tyour metrics, you are creating a new variation of that metric. For example, many Amazon EC2 metrics publish\n\t\tInstanceId
as a dimension name, and the actual instance ID as the value for that dimension.
You \n\t\tcan assign up to 30 dimensions to a metric.
" } }, "com.amazonaws.cloudwatch#DimensionFilter": { @@ -1542,7 +1542,7 @@ "traits": { "smithy.api#length": { "min": 1, - "max": 255 + "max": 1024 } } }, @@ -1554,7 +1554,7 @@ "traits": { "smithy.api#length": { "min": 0, - "max": 10 + "max": 30 } } }, @@ -1726,10 +1726,7 @@ "type": "string" }, "com.amazonaws.cloudwatch#ExtendedStatistic": { - "type": "string", - "traits": { - "smithy.api#pattern": "^p(\\d{1,2}(\\.\\d{0,2})?|100)$" - } + "type": "string" }, "com.amazonaws.cloudwatch#ExtendedStatistics": { "type": "list", @@ -3560,7 +3557,7 @@ "Values": { "target": "com.amazonaws.cloudwatch#Values", "traits": { - "smithy.api#documentation": "Array of numbers representing the values for the metric during the period. Each unique value is listed just once\n\t\tin this array, and the corresponding number in the Counts
array specifies the number of times that value occurred during the period.\n\t\tYou can include up to 150 unique values in each PutMetricData
action that specifies a Values
array.
Although the Values
array accepts numbers of type\n\t\t\tDouble
, CloudWatch rejects values that are either too small\n\t\t\tor too large. Values must be in the range of -2^360 to 2^360. In addition, special values (for example, NaN, +Infinity,\n\t\t\t-Infinity) are not supported.
Array of numbers representing the values for the metric during the period. Each unique value is listed just once\n\t\tin this array, and the corresponding number in the Counts
array specifies the number of times that value occurred during the period.\n\t\tYou can include up to 500 unique values in each PutMetricData
action that specifies a Values
array.
Although the Values
array accepts numbers of type\n\t\t\tDouble
, CloudWatch rejects values that are either too small\n\t\t\tor too large. Values must be in the range of -2^360 to 2^360. In addition, special values (for example, NaN, +Infinity,\n\t\t\t-Infinity) are not supported.
The unit of measure for the statistic. For example, the units for the Amazon EC2\n\t\t\tNetworkIn metric are Bytes because NetworkIn tracks the number of bytes that an instance\n\t\t\treceives on all network interfaces. You can also specify a unit when you create a custom\n\t\t\tmetric. Units help provide conceptual meaning to your data. Metric data points that\n\t\t\tspecify a unit of measure, such as Percent, are aggregated separately.
\n\t\tIf you don't specify Unit
, CloudWatch retrieves all unit types that have been published for the\n\t\t\tmetric and attempts to evaluate the alarm.\n\t\t\tUsually, metrics are\n\t\t\tpublished with only one unit, so the alarm\n\t\t\tworks as intended.
However, if the metric is published with multiple types of units and you don't specify a unit, the alarm's\n\t\t\tbehavior is not defined and\n\t\t\tit behaves predictably.
\n\t\tWe recommend omitting Unit
so that you don't inadvertently\n\t\t\tspecify an incorrect unit that is not published for this metric. Doing so \n\t\t\tcauses the alarm to be stuck in the INSUFFICIENT DATA
state.
The unit of measure for the statistic. For example, the units for the Amazon EC2\n\t\t\tNetworkIn metric are Bytes because NetworkIn tracks the number of bytes that an instance\n\t\t\treceives on all network interfaces. You can also specify a unit when you create a custom\n\t\t\tmetric. Units help provide conceptual meaning to your data. Metric data points that\n\t\t\tspecify a unit of measure, such as Percent, are aggregated separately.
\n\t\tIf you don't specify Unit
, CloudWatch retrieves all unit types that have been published for the\n\t\t\tmetric and attempts to evaluate the alarm.\n\t\t\tUsually, metrics are\n\t\t\tpublished with only one unit, so the alarm\n\t\t\tworks as intended.
However, if the metric is published with multiple types of units and you don't specify a unit, the alarm's\n\t\t\tbehavior is not defined and\n\t\t\tit behaves unpredictably.
\n\t\tWe recommend omitting Unit
so that you don't inadvertently\n\t\t\tspecify an incorrect unit that is not published for this metric. Doing so \n\t\t\tcauses the alarm to be stuck in the INSUFFICIENT DATA
state.
Publishes metric data points to Amazon CloudWatch. CloudWatch associates\n\t\t\tthe data points with the specified metric. If the specified metric does not exist,\n\t\t\tCloudWatch creates the metric. When CloudWatch creates a metric, it can\n\t\t\ttake up to fifteen minutes for the metric to appear in calls to ListMetrics.
\n\n\t\tYou can publish either individual data points in the Value
field, or \n\t\tarrays of values and the number of times each value occurred during the period by using the \n\t\tValues
and Counts
fields in the MetricDatum
structure. Using\n\t\tthe Values
and Counts
method enables you to publish up to 150 values per metric\n\t\t\twith one PutMetricData
request, and\n\t\tsupports retrieving percentile statistics on this data.
Each PutMetricData
request is limited to 40 KB in size for HTTP POST requests. You can \n\t\t\tsend a payload compressed by gzip. Each request\n\t\tis also limited to no more than 20 different metrics.
Although the Value
parameter accepts numbers of type\n\t\t\tDouble
, CloudWatch rejects values that are either too small\n\t\t\tor too large. Values must be in the range of -2^360 to 2^360. In addition, special values (for example, NaN, +Infinity,\n\t\t\t-Infinity) are not supported.
You can use up to 10 dimensions per metric to further clarify what data the metric collects. Each dimension\n\t\t\tconsists of a Name and Value pair. For more information about specifying dimensions, see Publishing Metrics in the\n\t\t\tAmazon CloudWatch User Guide.
\n\n\t\tYou specify the time stamp to be associated with each data point. You can specify\n\t\ttime stamps that are as much as two weeks before the current date, and as much as 2 hours after \n\t\tthe current day and time.
\n\t\tData points with time stamps from 24 hours ago or longer can take at least 48\n\t\t\thours to become available for GetMetricData or \n\t\t\tGetMetricStatistics from the time they \n\t\t\tare submitted. Data points with time stamps between 3 and 24 hours ago can take as much as 2 hours to become available\n\t\t\tfor for GetMetricData or \n\t\t\tGetMetricStatistics.
\n\t\tCloudWatch needs raw data points to calculate percentile statistics. If you publish \n\t\t\tdata using a statistic set instead, you can only retrieve \n\t\t\tpercentile statistics for this data if one of the following conditions is true:
\n\t\t\tThe SampleCount
value of the statistic set is 1 and Min
,\n\t\t\t\t\tMax
, and Sum
are all equal.
The Min
and\n\t\t\t\t\tMax
are equal, and Sum
is equal to Min
\n\t\t\t\t\tmultiplied by SampleCount
.
Publishes metric data points to Amazon CloudWatch. CloudWatch associates\n\t\t\tthe data points with the specified metric. If the specified metric does not exist,\n\t\t\tCloudWatch creates the metric. When CloudWatch creates a metric, it can\n\t\t\ttake up to fifteen minutes for the metric to appear in calls to ListMetrics.
\n\n\t\tYou can publish either individual data points in the Value
field, or \n\t\tarrays of values and the number of times each value occurred during the period by using the \n\t\tValues
and Counts
fields in the MetricDatum
structure. Using\n\t\tthe Values
and Counts
method enables you to publish up to 150 values per metric\n\t\t\twith one PutMetricData
request, and\n\t\tsupports retrieving percentile statistics on this data.
Each PutMetricData
request is limited to 1 MB in size for HTTP POST requests. You can \n\t\t\tsend a payload compressed by gzip. Each request\n\t\tis also limited to no more than 1000 different metrics.
Although the Value
parameter accepts numbers of type\n\t\t\tDouble
, CloudWatch rejects values that are either too small\n\t\t\tor too large. Values must be in the range of -2^360 to 2^360. In addition, special values (for example, NaN, +Infinity,\n\t\t\t-Infinity) are not supported.
You can use up to 30 dimensions per metric to further clarify what data the metric collects. Each dimension\n\t\t\tconsists of a Name and Value pair. For more information about specifying dimensions, see Publishing Metrics in the\n\t\t\tAmazon CloudWatch User Guide.
\n\n\t\tYou specify the time stamp to be associated with each data point. You can specify\n\t\ttime stamps that are as much as two weeks before the current date, and as much as 2 hours after \n\t\tthe current day and time.
\n\t\tData points with time stamps from 24 hours ago or longer can take at least 48\n\t\t\thours to become available for GetMetricData or \n\t\t\tGetMetricStatistics from the time they \n\t\t\tare submitted. Data points with time stamps between 3 and 24 hours ago can take as much as 2 hours to become available\n\t\t\tfor for GetMetricData or \n\t\t\tGetMetricStatistics.
\n\t\tCloudWatch needs raw data points to calculate percentile statistics. If you publish \n\t\t\tdata using a statistic set instead, you can only retrieve \n\t\t\tpercentile statistics for this data if one of the following conditions is true:
\n\t\t\tThe SampleCount
value of the statistic set is 1 and Min
,\n\t\t\t\t\tMax
, and Sum
are all equal.
The Min
and\n\t\t\t\t\tMax
are equal, and Sum
is equal to Min
\n\t\t\t\t\tmultiplied by SampleCount
.
The data for the metric. The array can include no more than 20 metrics per call.
", + "smithy.api#documentation": "The data for the metric. The array can include no more than 1000 metrics per call.
", "smithy.api#required": {} } } diff --git a/codegen/sdk-codegen/aws-models/location.json b/codegen/sdk-codegen/aws-models/location.json index dc68736bd0d..7e0cc2f2bcb 100644 --- a/codegen/sdk-codegen/aws-models/location.json +++ b/codegen/sdk-codegen/aws-models/location.json @@ -669,7 +669,7 @@ "Geometry": { "target": "com.amazonaws.location#GeofenceGeometry", "traits": { - "smithy.api#documentation": "Contains the polygon details to specify the position of the geofence.
\nEach geofence polygon can have a maximum of 1,000 vertices.
\nContains the details of the position of the geofence. Can be either a \n polygon or a circle. Including both will return a validation error.
\nEach \n geofence polygon can have a maximum of 1,000 vertices.
\n\n Calculates a route given the following required parameters:\n DeparturePosition
and DestinationPosition
. Requires that\n you first create a\n route calculator resource.
By default, a request that doesn't specify a departure time uses the best time of day\n to travel with the best traffic conditions when calculating the route.
\nAdditional options include:
\n\n Specifying a\n departure time using either DepartureTime
or\n DepartNow
. This calculates a route based on predictive traffic\n data at the given time.
You can't specify both DepartureTime
and\n DepartNow
in a single request. Specifying both parameters\n returns a validation error.
\n Specifying a travel\n mode using TravelMode sets the transportation mode used to calculate\n the routes. This also lets you specify additional route preferences in\n CarModeOptions
if traveling by Car
, or\n TruckModeOptions
if traveling by Truck
.
\n Calculates a route given the following required parameters:\n DeparturePosition
and DestinationPosition
. Requires that\n you first create a\n route calculator resource.
By default, a request that doesn't specify a departure time uses the best time of day\n to travel with the best traffic conditions when calculating the route.
\nAdditional options include:
\n\n Specifying a\n departure time using either DepartureTime
or\n DepartNow
. This calculates a route based on predictive traffic\n data at the given time.
You can't specify both DepartureTime
and\n DepartNow
in a single request. Specifying both parameters\n returns a validation error.
\n Specifying a travel\n mode using TravelMode sets the transportation mode used to calculate\n the routes. This also lets you specify additional route preferences in\n CarModeOptions
if traveling by Car
, or\n TruckModeOptions
if traveling by Truck
.
If you specify walking
for the travel mode and your data \n provider is Esri, the start and destination must be within 40km.
Specifies the mode of transport when calculating a route. Used in estimating the speed\n of travel and road compatibility.
\nThe TravelMode
you specify also determines how you specify route\n preferences:
If traveling by Car
use the CarModeOptions
\n parameter.
If traveling by Truck
use the TruckModeOptions
\n parameter.
Default Value: Car
\n
Specifies the mode of transport when calculating a route. Used in estimating the speed\n of travel and road compatibility. You can choose Car
, Truck
, \n or Walking
as options for the TravelMode
.
The TravelMode
you specify also determines how you specify route\n preferences:
If traveling by Car
use the CarModeOptions
\n parameter.
If traveling by Truck
use the TruckModeOptions
\n parameter.
Default Value: Car
\n
Contains details about additional route preferences for requests that specify\n TravelMode
as Truck
.
A single point geometry, specifying the center of the circle, using WGS 84\n coordinates, in the form [longitude, latitude]
.
The radius of the circle in meters. Must be greater than zero and no \n larger than 100,000 (100 kilometers).
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#documentation": "A circle on the earth, as defined by a center point and a radius.
", + "smithy.api#sensitive": {} + } + }, "com.amazonaws.location#ConflictException": { "type": "structure", "members": { @@ -3038,12 +3061,18 @@ "Polygon": { "target": "com.amazonaws.location#LinearRings", "traits": { - "smithy.api#documentation": "An array of 1 or more linear rings. A linear ring is an array of 4 or more vertices,\n where the first and last vertex are the same to form a closed boundary. Each vertex is a\n 2-dimensional point of the form: [longitude, latitude]
.
The first linear ring is an outer ring, describing the polygon's boundary. Subsequent\n linear rings may be inner or outer rings to describe holes and islands. Outer rings must\n list their vertices in counter-clockwise order around the ring's center, where the left\n side is the polygon's exterior. Inner rings must list their vertices in clockwise order,\n where the left side is the polygon's interior.
" + "smithy.api#documentation": "An array of 1 or more linear rings. A linear ring is an array of 4 or more vertices,\n where the first and last vertex are the same to form a closed boundary. Each vertex is a\n 2-dimensional point of the form: [longitude, latitude]
.
The first linear ring is an outer ring, describing the polygon's boundary. Subsequent\n linear rings may be inner or outer rings to describe holes and islands. Outer rings must\n list their vertices in counter-clockwise order around the ring's center, where the left\n side is the polygon's exterior. Inner rings must list their vertices in clockwise order,\n where the left side is the polygon's interior.
\nA geofence polygon can consist of between 4 and 1,000 vertices.
" + } + }, + "Circle": { + "target": "com.amazonaws.location#Circle", + "traits": { + "smithy.api#documentation": "A circle on the earth, as defined by a center point and a radius.
" } } }, "traits": { - "smithy.api#documentation": "Contains the geofence geometry details.
\nAmazon Location doesn't currently support polygons with holes, multipolygons, polygons\n that are wound clockwise, or that cross the antimeridian.
\nContains the geofence geometry details.
\nA geofence geometry is made up of either a polygon or a circle. Can be either a \n polygon or a circle. Including both will return a validation error.
\nAmazon Location doesn't currently support polygons with holes, multipolygons, polygons\n that are wound clockwise, or that cross the antimeridian.
\nContains the geofence geometry details describing a polygon.
", + "smithy.api#documentation": "Contains the geofence geometry details describing a polygon or a circle.
", "smithy.api#required": {} } }, @@ -3407,7 +3436,7 @@ "FontStack": { "target": "smithy.api#String", "traits": { - "smithy.api#documentation": "A comma-separated list of fonts to load glyphs from in order of preference. For\n example, Noto Sans Regular, Arial Unicode
.
Valid fonts stacks for Esri styles:
\nVectorEsriDarkGrayCanvas – Ubuntu Medium Italic
| Ubuntu\n Medium
| Ubuntu Italic
| Ubuntu Regular
|\n Ubuntu Bold
\n
VectorEsriLightGrayCanvas – Ubuntu Italic
| Ubuntu\n Regular
| Ubuntu Light
| Ubuntu Bold
\n
VectorEsriTopographic – Noto Sans Italic
| Noto Sans\n Regular
| Noto Sans Bold
| Noto Serif\n Regular
| Roboto Condensed Light Italic
\n
VectorEsriStreets – Arial Regular
| Arial Italic
|\n Arial Bold
\n
VectorEsriNavigation – Arial Regular
| Arial Italic
\n | Arial Bold
\n
Valid font stacks for HERE Technologies styles:
\nVectorHereBerlin – Fira \n GO Regular
| Fira GO Bold
\n
VectorHereExplore, VectorHereExploreTruck – Firo GO Italic
| \n Fira GO Map
| Fira GO Map Bold
| Noto Sans CJK \n JP Bold
| Noto Sans CJK JP Light
| Noto Sans CJK \n JP Regular
\n
A comma-separated list of fonts to load glyphs from in order of preference. For\n example, Noto Sans Regular, Arial Unicode
.
Valid fonts stacks for Esri styles:
\nVectorEsriDarkGrayCanvas – Ubuntu Medium Italic
| Ubuntu\n Medium
| Ubuntu Italic
| Ubuntu Regular
|\n Ubuntu Bold
\n
VectorEsriLightGrayCanvas – Ubuntu Italic
| Ubuntu\n Regular
| Ubuntu Light
| Ubuntu Bold
\n
VectorEsriTopographic – Noto Sans Italic
| Noto Sans\n Regular
| Noto Sans Bold
| Noto Serif\n Regular
| Roboto Condensed Light Italic
\n
VectorEsriStreets – Arial Regular
| Arial Italic
|\n Arial Bold
\n
VectorEsriNavigation – Arial Regular
| Arial Italic
\n | Arial Bold
\n
Valid font stacks for HERE Technologies styles:
\nVectorHereContrast – Fira \n GO Regular
| Fira GO Bold
\n
VectorHereExplore, VectorHereExploreTruck – Firo GO Italic
| \n Fira GO Map
| Fira GO Map Bold
| Noto Sans CJK \n JP Bold
| Noto Sans CJK JP Light
| Noto Sans CJK \n JP Regular
\n
Contains the geofence geometry details describing a polygon.
", + "smithy.api#documentation": "Contains the geofence geometry details describing a polygon or a circle.
", "smithy.api#required": {} } }, @@ -5005,7 +5034,7 @@ "name": "geo" }, "aws.protocols#restJson1": {}, - "smithy.api#documentation": "Suite of geospatial services including Maps, Places, Routes, Tracking, and Geofencing", + "smithy.api#documentation": "\"Suite of geospatial services including Maps, Places, Routes, Tracking, and Geofencing\"
", "smithy.api#title": "Amazon Location Service" }, "version": "2020-11-19", @@ -5036,7 +5065,7 @@ "Style": { "target": "com.amazonaws.location#MapStyle", "traits": { - "smithy.api#documentation": "Specifies the map style selected from an available data provider.
\nValid Esri map styles:
\n\n VectorEsriDarkGrayCanvas
– The Esri Dark Gray Canvas map style. A\n vector basemap with a dark gray, neutral background with minimal colors, labels,\n and features that's designed to draw attention to your thematic content.
\n RasterEsriImagery
– The Esri Imagery map style. A raster basemap\n that provides one meter or better satellite and aerial imagery in many parts of\n the world and lower resolution satellite imagery worldwide.
\n VectorEsriLightGrayCanvas
– The Esri Light Gray Canvas map style,\n which provides a detailed vector basemap with a light gray, neutral background\n style with minimal colors, labels, and features that's designed to draw\n attention to your thematic content.
\n VectorEsriTopographic
– The Esri Light map style, which provides\n a detailed vector basemap with a classic Esri map style.
\n VectorEsriStreets
– The Esri World Streets map style, which\n provides a detailed vector basemap for the world symbolized with a classic Esri\n street map style. The vector tile layer is similar in content and style to the\n World Street Map raster map.
\n VectorEsriNavigation
– The Esri World Navigation map style, which\n provides a detailed basemap for the world symbolized with a custom navigation\n map style that's designed for use during the day in mobile devices.
Valid HERE\n Technologies map styles:
\n\n VectorHereBerlin
– The HERE Berlin map style is a high contrast\n detailed base map of the world that blends 3D and 2D rendering.
\n VectorHereExplore
– A default HERE map style containing a \n neutral, global map and its features including roads, buildings, landmarks, \n and water features. It also now includes a fully designed map of Japan.
\n VectorHereExploreTruck
– A global map containing truck \n restrictions and attributes (e.g. width / height / HAZMAT) symbolized with \n highlighted segments and icons on top of HERE Explore to support use cases \n within transport and logistics.
Specifies the map style selected from an available data provider.
\nValid Esri map styles:
\n\n VectorEsriDarkGrayCanvas
– The Esri Dark Gray Canvas map style. A\n vector basemap with a dark gray, neutral background with minimal colors, labels,\n and features that's designed to draw attention to your thematic content.
\n RasterEsriImagery
– The Esri Imagery map style. A raster basemap\n that provides one meter or better satellite and aerial imagery in many parts of\n the world and lower resolution satellite imagery worldwide.
\n VectorEsriLightGrayCanvas
– The Esri Light Gray Canvas map style,\n which provides a detailed vector basemap with a light gray, neutral background\n style with minimal colors, labels, and features that's designed to draw\n attention to your thematic content.
\n VectorEsriTopographic
– The Esri Light map style, which provides\n a detailed vector basemap with a classic Esri map style.
\n VectorEsriStreets
– The Esri World Streets map style, which\n provides a detailed vector basemap for the world symbolized with a classic Esri\n street map style. The vector tile layer is similar in content and style to the\n World Street Map raster map.
\n VectorEsriNavigation
– The Esri World Navigation map style, which\n provides a detailed basemap for the world symbolized with a custom navigation\n map style that's designed for use during the day in mobile devices.
Valid HERE\n Technologies map styles:
\n\n VectorHereContrast
– The HERE Contrast (Berlin) map style is a high contrast\n detailed base map of the world that blends 3D and 2D rendering.
\n VectorHereExplore
– A default HERE map style containing a \n neutral, global map and its features including roads, buildings, landmarks, \n and water features. It also now includes a fully designed map of Japan.
\n VectorHereExploreTruck
– A global map containing truck \n restrictions and attributes (e.g. width / height / HAZMAT) symbolized with \n highlighted segments and icons on top of HERE Explore to support use cases \n within transport and logistics.
The VectorHereContrast
style has been renamed from VectorHereBerlin
. \n VectorHereBerlin
has been deprecated, but will continue to work in \n applications that use it.
Contains the polygon details to specify the position of the geofence.
\nEach geofence polygon can have a maximum of 1,000 vertices.
\nContains the details to specify the position of the geofence. Can be either a \n polygon or a circle. Including both will return a validation error.
\nEach \n geofence polygon can have a maximum of 1,000 vertices.
\nThe length of the truck.
\nFor example, 15.5
.
The length of the truck.
\nFor example, 15.5
.
\n For routes calculated with a HERE resource, this value must be between 0 and 300 meters.\n
\nThe height of the truck.
\nFor example, 4.5
.
The height of the truck.
\nFor example, 4.5
.
\n For routes calculated with a HERE resource, this value must be between 0 and 50 meters.\n
\nThe width of the truck.
\nFor example, 4.5
.
The width of the truck.
\nFor example, 4.5
.
\n For routes calculated with a HERE resource, this value must be between 0 and 50 meters.\n
\nAmazon Augmented AI (Amazon A2I) adds the benefit of human judgment to any machine learning\n application. When an AI application can't evaluate data with a high degree of confidence,\n human reviewers can take over. This human review is called a human review workflow. To create\n and start a human review workflow, you need three resources: a worker task\n template, a flow definition, and a human\n loop.
\nFor information about these resources and prerequisites for using Amazon A2I, see Get Started with\n Amazon Augmented AI in the Amazon SageMaker Developer Guide.
\nThis API reference includes information about API actions and data types that you can use\n to interact with Amazon A2I programmatically. Use this guide to:
\nStart a human loop with the StartHumanLoop
operation when using\n Amazon A2I with a custom task type. To learn more about the\n difference between custom and built-in task types, see Use Task Types . To learn\n how to start a human loop using this API, see Create and Start a Human Loop for a Custom Task Type in the\n Amazon SageMaker Developer Guide.
Manage your human loops. You can list all human loops that you have created, describe\n individual human loops, and stop and delete human loops. To learn more, see Monitor and Manage Your Human Loop in the Amazon SageMaker Developer Guide.
\nAmazon A2I integrates APIs from various AWS services to create and start human review\n workflows for those services. To learn how Amazon A2I uses these APIs, see Use APIs in\n Amazon A2I in the Amazon SageMaker Developer Guide.
", + "smithy.api#title": "Amazon Augmented AI Runtime" + }, "version": "2019-11-07", "operations": [ { @@ -48,22 +63,7 @@ { "target": "com.amazonaws.sagemakera2iruntime#StopHumanLoop" } - ], - "traits": { - "aws.api#service": { - "sdkId": "SageMaker A2I Runtime", - "arnNamespace": "sagemaker", - "cloudFormationName": "SageMakerA2IRuntime", - "cloudTrailEventSource": "sagemakera2iruntime.amazonaws.com", - "endpointPrefix": "a2i-runtime.sagemaker" - }, - "aws.auth#sigv4": { - "name": "sagemaker" - }, - "aws.protocols#restJson1": {}, - "smithy.api#documentation": "Amazon Augmented AI (Amazon A2I) adds the benefit of human judgment to any machine learning\n application. When an AI application can't evaluate data with a high degree of confidence,\n human reviewers can take over. This human review is called a human review workflow. To create\n and start a human review workflow, you need three resources: a worker task\n template, a flow definition, and a human\n loop.
\nFor information about these resources and prerequisites for using Amazon A2I, see Get Started with\n Amazon Augmented AI in the Amazon SageMaker Developer Guide.
\nThis API reference includes information about API actions and data types that you can use\n to interact with Amazon A2I programmatically. Use this guide to:
\nStart a human loop with the StartHumanLoop
operation when using\n Amazon A2I with a custom task type. To learn more about the\n difference between custom and built-in task types, see Use Task Types . To learn\n how to start a human loop using this API, see Create and Start a Human Loop for a Custom Task Type in the\n Amazon SageMaker Developer Guide.
Manage your human loops. You can list all human loops that you have created, describe\n individual human loops, and stop and delete human loops. To learn more, see Monitor and Manage Your Human Loop in the Amazon SageMaker Developer Guide.
\nAmazon A2I integrates APIs from various AWS services to create and start human review\n workflows for those services. To learn how Amazon A2I uses these APIs, see Use APIs in\n Amazon A2I in the Amazon SageMaker Developer Guide.
", - "smithy.api#title": "Amazon Augmented AI Runtime" - } + ] }, "com.amazonaws.sagemakera2iruntime#ConflictException": { "type": "structure", @@ -271,7 +271,7 @@ "min": 0, "max": 1024 }, - "smithy.api#pattern": "arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:flow-definition/.*" + "smithy.api#pattern": "^arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:flow-definition/" } }, "com.amazonaws.sagemakera2iruntime#HumanLoopArn": { @@ -281,7 +281,7 @@ "min": 0, "max": 1024 }, - "smithy.api#pattern": "arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:human-loop/.*" + "smithy.api#pattern": "^arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:human-loop/" } }, "com.amazonaws.sagemakera2iruntime#HumanLoopDataAttributes": { @@ -464,6 +464,7 @@ "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", + "items": "HumanLoopSummaries", "pageSize": "MaxResults" } } @@ -736,7 +737,10 @@ } }, "com.amazonaws.sagemakera2iruntime#Timestamp": { - "type": "timestamp" + "type": "timestamp", + "traits": { + "smithy.api#timestampFormat": "date-time" + } }, "com.amazonaws.sagemakera2iruntime#ValidationException": { "type": "structure", diff --git a/codegen/sdk-codegen/aws-models/sagemaker.json b/codegen/sdk-codegen/aws-models/sagemaker.json index b04e2a4f145..824f47adb10 100644 --- a/codegen/sdk-codegen/aws-models/sagemaker.json +++ b/codegen/sdk-codegen/aws-models/sagemaker.json @@ -240,7 +240,7 @@ "target": "com.amazonaws.sagemaker#AddTagsOutput" }, "traits": { - "smithy.api#documentation": "Adds or overwrites one or more tags for the specified SageMaker resource. You can add\n tags to notebook instances, training jobs, hyperparameter tuning jobs, batch transform\n jobs, models, labeling jobs, work teams, endpoint configurations, and\n endpoints.
\nEach tag consists of a key and an optional value. Tag keys must be unique per\n resource. For more information about tags, see For more information, see Amazon Web Services\n Tagging Strategies.
\nTags that you add to a hyperparameter tuning job by calling this API are also\n added to any training jobs that the hyperparameter tuning job launches after you\n call this API, but not to training jobs that the hyperparameter tuning job launched\n before you called this API. To make sure that the tags associated with a\n hyperparameter tuning job are also added to all training jobs that the\n hyperparameter tuning job launches, add the tags when you first create the tuning\n job by specifying them in the Tags
parameter of CreateHyperParameterTuningJob\n
Tags that you add to a SageMaker Studio Domain or User Profile by calling this API\n are also added to any Apps that the Domain or User Profile launches after you call\n this API, but not to Apps that the Domain or User Profile launched before you called\n this API. To make sure that the tags associated with a Domain or User Profile are\n also added to all Apps that the Domain or User Profile launches, add the tags when\n you first create the Domain or User Profile by specifying them in the\n Tags
parameter of CreateDomain or CreateUserProfile.
Adds or overwrites one or more tags for the specified SageMaker resource. You can add\n tags to notebook instances, training jobs, hyperparameter tuning jobs, batch transform\n jobs, models, labeling jobs, work teams, endpoint configurations, and\n endpoints.
\nEach tag consists of a key and an optional value. Tag keys must be unique per\n resource. For more information about tags, see For more information, see Amazon Web Services Tagging Strategies.
\nTags that you add to a hyperparameter tuning job by calling this API are also\n added to any training jobs that the hyperparameter tuning job launches after you\n call this API, but not to training jobs that the hyperparameter tuning job launched\n before you called this API. To make sure that the tags associated with a\n hyperparameter tuning job are also added to all training jobs that the\n hyperparameter tuning job launches, add the tags when you first create the tuning\n job by specifying them in the Tags
parameter of CreateHyperParameterTuningJob\n
Tags that you add to a SageMaker Studio Domain or User Profile by calling this API\n are also added to any Apps that the Domain or User Profile launches after you call\n this API, but not to Apps that the Domain or User Profile launched before you called\n this API. To make sure that the tags associated with a Domain or User Profile are\n also added to all Apps that the Domain or User Profile launches, add the tags when\n you first create the Domain or User Profile by specifying them in the\n Tags
parameter of CreateDomain or CreateUserProfile.
An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
", + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
", "smithy.api#required": {} } } @@ -454,13 +454,13 @@ "TrainingImage": { "target": "com.amazonaws.sagemaker#AlgorithmImage", "traits": { - "smithy.api#documentation": "The registry path of the Docker image\n that contains the training algorithm.\n For information about docker registry paths for SageMaker built-in algorithms, see Docker Registry Paths and Example Code in the Amazon SageMaker developer guide. \n SageMaker supports both registry/repository[:tag]
and registry/repository[@digest]
\n image path formats. For more information about using your custom training container, see Using Your Own Algorithms with Amazon SageMaker.
You must specify either the algorithm name to the AlgorithmName
parameter \n or the image URI of the algorithm container \n to the TrainingImage
parameter.
For more information, see the note in the AlgorithmName
parameter description.
The registry path of the Docker image\n that contains the training algorithm.\n For information about docker registry paths for SageMaker built-in algorithms, see Docker Registry\n Paths and Example Code in the Amazon SageMaker developer guide.\n SageMaker supports both registry/repository[:tag]
and\n registry/repository[@digest]
image path formats. For more information\n about using your custom training container, see Using Your Own Algorithms with\n Amazon SageMaker.
You must specify either the algorithm name to the AlgorithmName
\n parameter or the image URI of the algorithm container to the\n TrainingImage
parameter.
For more information, see the note in the AlgorithmName
parameter\n description.
The name of the algorithm resource to use for the training job. This must be an\n algorithm resource that you created or subscribe to on Amazon Web Services Marketplace.
\nYou must specify either the algorithm name to the AlgorithmName
parameter \n or the image URI of the algorithm container \n to the TrainingImage
parameter.
Note that the AlgorithmName
parameter is mutually exclusive \n with the TrainingImage
parameter. \n If you specify a value for the AlgorithmName
parameter,\n you can't specify a value for TrainingImage
, and vice versa.
If you specify values for both parameters, the training job might break; if you don't specify\n any value for both parameters, the training job might raise a null
error.
The name of the algorithm resource to use for the training job. This must be an\n algorithm resource that you created or subscribe to on Amazon Web Services\n Marketplace.
\nYou must specify either the algorithm name to the AlgorithmName
\n parameter or the image URI of the algorithm container to the\n TrainingImage
parameter.
Note that the AlgorithmName
parameter is mutually exclusive with the\n TrainingImage
parameter. If you specify a value for the\n AlgorithmName
parameter, you can't specify a value for\n TrainingImage
, and vice versa.
If you specify values for both parameters, the training job might break; if you\n don't specify any value for both parameters, the training job might raise a\n null
error.
Defines a training job and a batch transform job that SageMaker runs to validate your\n algorithm.
\nThe data provided in the validation profile is made available to your buyers on Amazon Web Services\n Marketplace.
" + "smithy.api#documentation": "Defines a training job and a batch transform job that SageMaker runs to validate your\n algorithm.
\nThe data provided in the validation profile is made available to your buyers on\n Amazon Web Services Marketplace.
" } }, "com.amazonaws.sagemaker#AlgorithmValidationProfiles": { @@ -1538,12 +1538,12 @@ "MaxConcurrentInvocationsPerInstance": { "target": "com.amazonaws.sagemaker#MaxConcurrentInvocationsPerInstance", "traits": { - "smithy.api#documentation": "The maximum number of concurrent requests sent by the SageMaker client to the \n model container. If no value is provided, SageMaker chooses an optimal value.
" + "smithy.api#documentation": "The maximum number of concurrent requests sent by the SageMaker client to the model\n container. If no value is provided, SageMaker chooses an optimal value.
" } } }, "traits": { - "smithy.api#documentation": "Configures the behavior of the client used by SageMaker to interact with the \n model container during asynchronous inference.
" + "smithy.api#documentation": "Configures the behavior of the client used by SageMaker to interact with the model\n container during asynchronous inference.
" } }, "com.amazonaws.sagemaker#AsyncInferenceConfig": { @@ -1552,7 +1552,7 @@ "ClientConfig": { "target": "com.amazonaws.sagemaker#AsyncInferenceClientConfig", "traits": { - "smithy.api#documentation": "Configures the behavior of the client used by SageMaker to interact \n with the model container during asynchronous inference.
" + "smithy.api#documentation": "Configures the behavior of the client used by SageMaker to interact with the model\n container during asynchronous inference.
" } }, "OutputConfig": { @@ -1573,18 +1573,18 @@ "SuccessTopic": { "target": "com.amazonaws.sagemaker#SnsTopicArn", "traits": { - "smithy.api#documentation": "Amazon SNS topic to post a notification to when inference completes successfully. \n If no topic is provided, no notification is sent on success.
" + "smithy.api#documentation": "Amazon SNS topic to post a notification to when inference completes successfully. If no\n topic is provided, no notification is sent on success.
" } }, "ErrorTopic": { "target": "com.amazonaws.sagemaker#SnsTopicArn", "traits": { - "smithy.api#documentation": "Amazon SNS topic to post a notification to when inference fails. \n If no topic is provided, no notification is sent on failure.
" + "smithy.api#documentation": "Amazon SNS topic to post a notification to when inference fails. If no topic is provided,\n no notification is sent on failure.
" } } }, "traits": { - "smithy.api#documentation": "Specifies the configuration for notifications of inference results for asynchronous inference.
" + "smithy.api#documentation": "Specifies the configuration for notifications of inference results for asynchronous\n inference.
" } }, "com.amazonaws.sagemaker#AsyncInferenceOutputConfig": { @@ -1593,7 +1593,7 @@ "KmsKeyId": { "target": "com.amazonaws.sagemaker#KmsKeyId", "traits": { - "smithy.api#documentation": "The Amazon Web Services Key Management Service (Amazon Web Services KMS) key that\n SageMaker uses to encrypt the asynchronous inference output in Amazon S3.
\n " + "smithy.api#documentation": "The Amazon Web Services Key Management Service (Amazon Web Services KMS) key that SageMaker\n uses to encrypt the asynchronous inference output in Amazon S3.
\n " } }, "S3OutputPath": { @@ -1606,7 +1606,7 @@ "NotificationConfig": { "target": "com.amazonaws.sagemaker#AsyncInferenceNotificationConfig", "traits": { - "smithy.api#documentation": "Specifies the configuration for notifications of inference results for asynchronous inference.
" + "smithy.api#documentation": "Specifies the configuration for notifications of inference results for asynchronous\n inference.
" } } }, @@ -2631,12 +2631,12 @@ "Alarms": { "target": "com.amazonaws.sagemaker#AlarmList", "traits": { - "smithy.api#documentation": "List of CloudWatch alarms in your account that are configured to monitor metrics on an endpoint.\n If any alarms are tripped during a deployment, SageMaker rolls back the deployment.
" + "smithy.api#documentation": "List of CloudWatch alarms in your account that are configured to monitor metrics on an\n endpoint. If any alarms are tripped during a deployment, SageMaker rolls back the\n deployment.
" } } }, "traits": { - "smithy.api#documentation": "Automatic rollback configuration for handling endpoint deployment failures and recovery.
" + "smithy.api#documentation": "Automatic rollback configuration for handling endpoint deployment failures and\n recovery.
" } }, "com.amazonaws.sagemaker#AwsManagedHumanLoopRequestSource": { @@ -2851,7 +2851,7 @@ "TrafficRoutingConfiguration": { "target": "com.amazonaws.sagemaker#TrafficRoutingConfig", "traits": { - "smithy.api#documentation": "Defines the traffic routing strategy to shift traffic from the old fleet to the new fleet\n during an endpoint deployment.
", + "smithy.api#documentation": "Defines the traffic routing strategy to shift traffic from the old fleet to the new\n fleet during an endpoint deployment.
", "smithy.api#required": {} } }, @@ -2864,7 +2864,7 @@ "MaximumExecutionTimeoutInSeconds": { "target": "com.amazonaws.sagemaker#MaximumExecutionTimeoutInSeconds", "traits": { - "smithy.api#documentation": "Maximum execution timeout for the deployment. Note that the timeout value should be larger\n than the total waiting time specified in TerminationWaitInSeconds
and WaitIntervalInSeconds
.
Maximum execution timeout for the deployment. Note that the timeout value should be\n larger than the total waiting time specified in TerminationWaitInSeconds
\n and WaitIntervalInSeconds
.
Specifies the endpoint capacity type.
\n\n INSTANCE_COUNT
: The endpoint activates based on\n the number of instances.
\n CAPACITY_PERCENT
: The endpoint activates based on\n the specified percentage of capacity.
Specifies the endpoint capacity type.
\n\n INSTANCE_COUNT
: The endpoint activates based on the number of\n instances.
\n CAPACITY_PERCENT
: The endpoint activates based on the specified\n percentage of capacity.
Defines the capacity size, either as a number of instances or a capacity percentage.
", + "smithy.api#documentation": "Defines the capacity size, either as a number of instances or a capacity\n percentage.
", "smithy.api#required": {} } } @@ -3701,7 +3701,7 @@ "GitConfig": { "target": "com.amazonaws.sagemaker#GitConfig", "traits": { - "smithy.api#documentation": "Configuration details for the Git repository, including the URL where it is located\n and the ARN of the Amazon Web Services Secrets Manager secret that contains the credentials used to\n access the repository.
" + "smithy.api#documentation": "Configuration details for the Git repository, including the URL where it is located\n and the ARN of the Amazon Web Services Secrets Manager secret that contains the\n credentials used to access the repository.
" } } }, @@ -4112,7 +4112,7 @@ "ModelDataUrl": { "target": "com.amazonaws.sagemaker#Url", "traits": { - "smithy.api#documentation": "The S3 path where the model artifacts, which result from model training, are stored.\n This path must point to a single gzip compressed tar archive (.tar.gz suffix). The S3\n path is required for SageMaker built-in algorithms, but not if you use your own algorithms.\n For more information on built-in algorithms, see Common\n Parameters.
\nThe model artifacts must be in an S3 bucket that is in the same region as the\n model or endpoint you are creating.
\nIf you provide a value for this parameter, SageMaker uses Amazon Web Services Security Token Service to\n download model artifacts from the S3 path you provide. Amazon Web Services STS is activated in your\n IAM user account by default. If you previously deactivated Amazon Web Services STS for a region, you\n need to reactivate Amazon Web Services STS for that region. For more information, see Activating and\n Deactivating Amazon Web Services STS in an Amazon Web Services Region in the Amazon Web Services Identity and Access Management User\n Guide.
\nIf you use a built-in algorithm to create a model, SageMaker requires that you provide\n a S3 path to the model artifacts in ModelDataUrl
.
The S3 path where the model artifacts, which result from model training, are stored.\n This path must point to a single gzip compressed tar archive (.tar.gz suffix). The S3\n path is required for SageMaker built-in algorithms, but not if you use your own algorithms.\n For more information on built-in algorithms, see Common\n Parameters.
\nThe model artifacts must be in an S3 bucket that is in the same region as the\n model or endpoint you are creating.
\nIf you provide a value for this parameter, SageMaker uses Amazon Web Services Security Token\n Service to download model artifacts from the S3 path you provide. Amazon Web Services STS\n is activated in your IAM user account by default. If you previously deactivated\n Amazon Web Services STS for a region, you need to reactivate Amazon Web Services STS\n for that region. For more information, see Activating and\n Deactivating Amazon Web Services STS in an Amazon Web Services Region in the\n Amazon Web Services Identity and Access Management User\n Guide.
\nIf you use a built-in algorithm to create a model, SageMaker requires that you provide\n a S3 path to the model artifacts in ModelDataUrl
.
Create a machine learning algorithm that you can use in SageMaker and list in the Amazon Web Services\n Marketplace.
" + "smithy.api#documentation": "Create a machine learning algorithm that you can use in SageMaker and list in the Amazon Web Services Marketplace.
" } }, "com.amazonaws.sagemaker#CreateAlgorithmInput": { @@ -4553,13 +4553,13 @@ "CertifyForMarketplace": { "target": "com.amazonaws.sagemaker#CertifyForMarketplace", "traits": { - "smithy.api#documentation": "Whether to certify the algorithm so that it can be listed in Amazon Web Services Marketplace.
" + "smithy.api#documentation": "Whether to certify the algorithm so that it can be listed in Amazon Web Services\n Marketplace.
" } }, "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } } } @@ -4632,7 +4632,7 @@ "KernelGatewayImageConfig": { "target": "com.amazonaws.sagemaker#KernelGatewayImageConfig", "traits": { - "smithy.api#documentation": "The KernelGatewayImageConfig.
" + "smithy.api#documentation": "The KernelGatewayImageConfig. You can only specify one image kernel in the \n\tAppImageConfig API. This kernel will be shown to users before the \n\timage starts. Once the image runs, all kernels are visible in JupyterLab.
" } } } @@ -4882,7 +4882,7 @@ "target": "com.amazonaws.sagemaker#CreateCodeRepositoryOutput" }, "traits": { - "smithy.api#documentation": "Creates a Git repository as a resource in your SageMaker account. You can associate the\n repository with notebook instances so that you can use Git source control for the\n notebooks you create. The Git repository is a resource in your SageMaker account, so it can\n be associated with more than one notebook instance, and it persists independently from\n the lifecycle of any notebook instances it is associated with.
\nThe repository can be hosted either in Amazon Web Services CodeCommit or in any\n other Git repository.
" + "smithy.api#documentation": "Creates a Git repository as a resource in your SageMaker account. You can associate the\n repository with notebook instances so that you can use Git source control for the\n notebooks you create. The Git repository is a resource in your SageMaker account, so it can\n be associated with more than one notebook instance, and it persists independently from\n the lifecycle of any notebook instances it is associated with.
\nThe repository can be hosted either in Amazon Web Services CodeCommit\n or in any other Git repository.
" } }, "com.amazonaws.sagemaker#CreateCodeRepositoryInput": { @@ -4905,7 +4905,7 @@ "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } } } @@ -5332,7 +5332,7 @@ "AppSecurityGroupManagement": { "target": "com.amazonaws.sagemaker#AppSecurityGroupManagement", "traits": { - "smithy.api#documentation": "The entity that creates and manages the required security groups for inter-app\n communication in VPCOnly
mode. Required when\n CreateDomain.AppNetworkAccessType
is VPCOnly
and\n DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is\n provided.
The entity that creates and manages the required security groups for inter-app\n communication in VPCOnly
mode. Required when\n CreateDomain.AppNetworkAccessType
is VPCOnly
and\n DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is\n provided.
Creates an endpoint using the endpoint configuration specified in the request. SageMaker\n uses the endpoint to provision resources and deploy models. You create the endpoint\n configuration with the CreateEndpointConfig API.
\nUse this API to deploy models using SageMaker hosting services.
\nFor an example that calls this method when deploying a model to SageMaker hosting services,\n see the Create Endpoint example notebook.\n
\n You must not delete an EndpointConfig
that is in use by an endpoint\n that is live or while the UpdateEndpoint
or CreateEndpoint
\n operations are being performed on the endpoint. To update an endpoint, you must\n create a new EndpointConfig
.
The endpoint name must be unique within an Amazon Web Services Region in your Amazon Web Services account.
\nWhen it receives the request, SageMaker creates the endpoint, launches the resources (ML\n compute instances), and deploys the model(s) on them.
\n \nWhen you call CreateEndpoint, a load call is made to DynamoDB to\n verify that your endpoint configuration exists. When you read data from a DynamoDB\n table supporting \n Eventually Consistent Reads
\n , the response might not\n reflect the results of a recently completed write operation. The response might\n include some stale data. If the dependent entities are not yet in DynamoDB, this\n causes a validation error. If you repeat your read request after a short time, the\n response should return the latest data. So retry logic is recommended to handle\n these possible issues. We also recommend that customers call DescribeEndpointConfig before calling CreateEndpoint to minimize the potential impact of a DynamoDB eventually consistent read.
When SageMaker receives the request, it sets the endpoint status to\n Creating
. After it creates the endpoint, it sets the status to\n InService
. SageMaker can then process incoming requests for inferences. To\n check the status of an endpoint, use the DescribeEndpoint\n API.
If any of the models hosted at this endpoint get model data from an Amazon S3 location,\n SageMaker uses Amazon Web Services Security Token Service to download model artifacts from the S3 path you\n provided. Amazon Web Services STS is activated in your IAM user account by default. If you previously\n deactivated Amazon Web Services STS for a region, you need to reactivate Amazon Web Services STS for that region. For\n more information, see Activating and\n Deactivating Amazon Web Services STS in an Amazon Web Services Region in the Amazon Web Services Identity and Access Management User\n Guide.
\nTo add the IAM role policies for using this API operation, go to the IAM console, and choose\n Roles in the left navigation pane. Search the IAM role that you want to grant\n access to use the CreateEndpoint and CreateEndpointConfig API operations, add the following policies to\n the role.
\nOption 1: For a full SageMaker access, search and attach the\n AmazonSageMakerFullAccess
policy.
Option 2: For granting a limited access to an IAM role, paste the\n following Action elements manually into the JSON file of the IAM role:
\n\n \"Action\": [\"sagemaker:CreateEndpoint\",\n \"sagemaker:CreateEndpointConfig\"]
\n
\n \"Resource\": [
\n
\n \"arn:aws:sagemaker:region:account-id:endpoint/endpointName\"
\n
\n \"arn:aws:sagemaker:region:account-id:endpoint-config/endpointConfigName\"
\n
\n ]
\n
For more information, see SageMaker API\n Permissions: Actions, Permissions, and Resources\n Reference.
\nCreates an endpoint using the endpoint configuration specified in the request. SageMaker\n uses the endpoint to provision resources and deploy models. You create the endpoint\n configuration with the CreateEndpointConfig API.
\nUse this API to deploy models using SageMaker hosting services.
\nFor an example that calls this method when deploying a model to SageMaker hosting services,\n see the Create Endpoint example notebook.\n
\n You must not delete an EndpointConfig
that is in use by an endpoint\n that is live or while the UpdateEndpoint
or CreateEndpoint
\n operations are being performed on the endpoint. To update an endpoint, you must\n create a new EndpointConfig
.
The endpoint name must be unique within an Amazon Web Services Region in your\n Amazon Web Services account.
\nWhen it receives the request, SageMaker creates the endpoint, launches the resources (ML\n compute instances), and deploys the model(s) on them.
\n \nWhen you call CreateEndpoint, a load call is made to DynamoDB to\n verify that your endpoint configuration exists. When you read data from a DynamoDB\n table supporting \n Eventually Consistent Reads
\n , the response might not\n reflect the results of a recently completed write operation. The response might\n include some stale data. If the dependent entities are not yet in DynamoDB, this\n causes a validation error. If you repeat your read request after a short time, the\n response should return the latest data. So retry logic is recommended to handle\n these possible issues. We also recommend that customers call DescribeEndpointConfig before calling CreateEndpoint to minimize the potential impact of a DynamoDB eventually consistent read.
When SageMaker receives the request, it sets the endpoint status to\n Creating
. After it creates the endpoint, it sets the status to\n InService
. SageMaker can then process incoming requests for inferences. To\n check the status of an endpoint, use the DescribeEndpoint\n API.
If any of the models hosted at this endpoint get model data from an Amazon S3 location,\n SageMaker uses Amazon Web Services Security Token Service to download model artifacts from the\n S3 path you provided. Amazon Web Services STS is activated in your IAM user account by\n default. If you previously deactivated Amazon Web Services STS for a region, you need to\n reactivate Amazon Web Services STS for that region. For more information, see Activating and\n Deactivating Amazon Web Services STS in an Amazon Web Services Region in the\n Amazon Web Services Identity and Access Management User\n Guide.
\nTo add the IAM role policies for using this API operation, go to the IAM console, and choose\n Roles in the left navigation pane. Search the IAM role that you want to grant\n access to use the CreateEndpoint and CreateEndpointConfig API operations, add the following policies to\n the role.
\nOption 1: For a full SageMaker access, search and attach the\n AmazonSageMakerFullAccess
policy.
Option 2: For granting a limited access to an IAM role, paste the\n following Action elements manually into the JSON file of the IAM role:
\n\n \"Action\": [\"sagemaker:CreateEndpoint\",\n \"sagemaker:CreateEndpointConfig\"]
\n
\n \"Resource\": [
\n
\n \"arn:aws:sagemaker:region:account-id:endpoint/endpointName\"
\n
\n \"arn:aws:sagemaker:region:account-id:endpoint-config/endpointConfigName\"
\n
\n ]
\n
For more information, see SageMaker API\n Permissions: Actions, Permissions, and Resources\n Reference.
\nAn array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } }, "KmsKeyId": { "target": "com.amazonaws.sagemaker#KmsKeyId", "traits": { - "smithy.api#documentation": "The Amazon Resource Name (ARN) of a Amazon Web Services Key Management Service key that SageMaker uses to encrypt data on\n the storage volume attached to the ML compute instance that hosts the endpoint.
\nThe KmsKeyId can be any of the following formats:
\nKey ID: 1234abcd-12ab-34cd-56ef-1234567890ab
\n
Key ARN:\n arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
\n
Alias name: alias/ExampleAlias
\n
Alias name ARN:\n arn:aws:kms:us-west-2:111122223333:alias/ExampleAlias
\n
The KMS key policy must grant permission to the IAM role that you specify in your\n CreateEndpoint
, UpdateEndpoint
requests. For more\n information, refer to the Amazon Web Services Key Management Service section Using Key\n Policies in Amazon Web Services KMS \n
Certain Nitro-based instances include local storage, dependent on the instance\n type. Local storage volumes are encrypted using a hardware module on the instance.\n You can't request a KmsKeyId
when using an instance type with local\n storage. If any of the models that you specify in the\n ProductionVariants
parameter use nitro-based instances with local\n storage, do not specify a value for the KmsKeyId
parameter. If you\n specify a value for KmsKeyId
when using any nitro-based instances with\n local storage, the call to CreateEndpointConfig
fails.
For a list of instance types that support local instance storage, see Instance Store Volumes.
\nFor more information about local instance storage encryption, see SSD\n Instance Store Volumes.
\nThe Amazon Resource Name (ARN) of a Amazon Web Services Key Management Service key that\n SageMaker uses to encrypt data on the storage volume attached to the ML compute instance that\n hosts the endpoint.
\nThe KmsKeyId can be any of the following formats:
\nKey ID: 1234abcd-12ab-34cd-56ef-1234567890ab
\n
Key ARN:\n arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
\n
Alias name: alias/ExampleAlias
\n
Alias name ARN:\n arn:aws:kms:us-west-2:111122223333:alias/ExampleAlias
\n
The KMS key policy must grant permission to the IAM role that you specify in your\n CreateEndpoint
, UpdateEndpoint
requests. For more\n information, refer to the Amazon Web Services Key Management Service section Using Key\n Policies in Amazon Web Services KMS \n
Certain Nitro-based instances include local storage, dependent on the instance\n type. Local storage volumes are encrypted using a hardware module on the instance.\n You can't request a KmsKeyId
when using an instance type with local\n storage. If any of the models that you specify in the\n ProductionVariants
parameter use nitro-based instances with local\n storage, do not specify a value for the KmsKeyId
parameter. If you\n specify a value for KmsKeyId
when using any nitro-based instances with\n local storage, the call to CreateEndpointConfig
fails.
For a list of instance types that support local instance storage, see Instance Store Volumes.
\nFor more information about local instance storage encryption, see SSD\n Instance Store Volumes.
\nSpecifies configuration for how an endpoint performs asynchronous inference. \n This is a required field in order for your Endpoint to be invoked using\n InvokeEndpointAsync.
" + "smithy.api#documentation": "Specifies configuration for how an endpoint performs asynchronous inference. This is a\n required field in order for your Endpoint to be invoked using InvokeEndpointAsync.
" } } } @@ -5631,7 +5631,7 @@ "EndpointName": { "target": "com.amazonaws.sagemaker#EndpointName", "traits": { - "smithy.api#documentation": "The name of the endpoint.The name must be unique within an Amazon Web Services Region in your Amazon Web Services\n account. The name is case-insensitive in CreateEndpoint
, but the case is\n preserved and must be matched in .
The name of the endpoint.The name must be unique within an Amazon Web Services\n Region in your Amazon Web Services account. The name is case-insensitive in\n CreateEndpoint
, but the case is preserved and must be matched in .
An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } } } @@ -5983,7 +5983,7 @@ "HyperParameterTuningJobName": { "target": "com.amazonaws.sagemaker#HyperParameterTuningJobName", "traits": { - "smithy.api#documentation": "The name of the tuning job. This name is the prefix for the names of all training jobs\n that this tuning job launches. The name must be unique within the same Amazon Web Services account and\n Amazon Web Services Region. The name must have 1 to 32 characters. Valid characters are a-z, A-Z, 0-9,\n and : + = @ _ % - (hyphen). The name is not case sensitive.
", + "smithy.api#documentation": "The name of the tuning job. This name is the prefix for the names of all training jobs\n that this tuning job launches. The name must be unique within the same Amazon Web Services account and Amazon Web Services Region. The name must have 1 to 32 characters. Valid\n characters are a-z, A-Z, 0-9, and : + = @ _ % - (hyphen). The name is not case\n sensitive.
", "smithy.api#required": {} } }, @@ -6015,7 +6015,7 @@ "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
\nTags that you specify for the tuning job are also added to all training jobs that the\n tuning job launches.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
\nTags that you specify for the tuning job are also added to all training jobs that the\n tuning job launches.
" } } } @@ -6367,7 +6367,7 @@ } ], "traits": { - "smithy.api#documentation": "Creates a model in SageMaker. In the request, you name the model and describe a primary\n container. For the primary container, you specify the Docker image that\n contains inference code, artifacts (from prior training), and a custom environment map\n that the inference code uses when you deploy the model for predictions.
\nUse this API to create a model if you want to use SageMaker hosting services or run a batch\n transform job.
\nTo host your model, you create an endpoint configuration with the\n CreateEndpointConfig
API, and then create an endpoint with the\n CreateEndpoint
API. SageMaker then deploys all of the containers that you\n defined for the model in the hosting environment.
For an example that calls this method when deploying a model to SageMaker hosting services,\n see Create a Model (Amazon Web Services SDK for Python (Boto\n 3)).\n
\nTo run a batch transform using your model, you start a job with the\n CreateTransformJob
API. SageMaker uses your model and your dataset to get\n inferences which are then saved to a specified S3 location.
In the request, you also provide an IAM role that SageMaker can assume to access model\n artifacts and docker image for deployment on ML compute hosting instances or for batch\n transform jobs. In addition, you also use the IAM role to manage permissions the\n inference code needs. For example, if the inference code access any other Amazon Web Services resources,\n you grant necessary permissions via this role.
" + "smithy.api#documentation": "Creates a model in SageMaker. In the request, you name the model and describe a primary\n container. For the primary container, you specify the Docker image that\n contains inference code, artifacts (from prior training), and a custom environment map\n that the inference code uses when you deploy the model for predictions.
\nUse this API to create a model if you want to use SageMaker hosting services or run a batch\n transform job.
\nTo host your model, you create an endpoint configuration with the\n CreateEndpointConfig
API, and then create an endpoint with the\n CreateEndpoint
API. SageMaker then deploys all of the containers that you\n defined for the model in the hosting environment.
For an example that calls this method when deploying a model to SageMaker hosting services,\n see Create a Model (Amazon Web Services SDK for Python (Boto 3)).\n
\nTo run a batch transform using your model, you start a job with the\n CreateTransformJob
API. SageMaker uses your model and your dataset to get\n inferences which are then saved to a specified S3 location.
In the request, you also provide an IAM role that SageMaker can assume to access model\n artifacts and docker image for deployment on ML compute hosting instances or for batch\n transform jobs. In addition, you also use the IAM role to manage permissions the\n inference code needs. For example, if the inference code access any other Amazon Web Services resources, you grant necessary permissions via this role.
" } }, "com.amazonaws.sagemaker#CreateModelBiasJobDefinition": { @@ -6604,7 +6604,7 @@ "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } }, "VpcConfig": { @@ -7033,20 +7033,20 @@ "RoleArn": { "target": "com.amazonaws.sagemaker#RoleArn", "traits": { - "smithy.api#documentation": "When you send any requests to Amazon Web Services resources from the notebook instance, SageMaker\n assumes this role to perform tasks on your behalf. You must grant this role necessary\n permissions so SageMaker can perform these tasks. The policy must allow the SageMaker service\n principal (sagemaker.amazonaws.com) permissions to assume this role. For more\n information, see SageMaker Roles.
\nTo be able to pass this role to SageMaker, the caller of this API must have the\n iam:PassRole
permission.
When you send any requests to Amazon Web Services resources from the notebook\n instance, SageMaker assumes this role to perform tasks on your behalf. You must grant this\n role necessary permissions so SageMaker can perform these tasks. The policy must allow the\n SageMaker service principal (sagemaker.amazonaws.com) permissions to assume this role. For\n more information, see SageMaker Roles.
\nTo be able to pass this role to SageMaker, the caller of this API must have the\n iam:PassRole
permission.
The Amazon Resource Name (ARN) of a Amazon Web Services Key Management Service key that SageMaker uses to encrypt data on\n the storage volume attached to your notebook instance. The KMS key you provide must be\n enabled. For information, see Enabling and Disabling\n Keys in the Amazon Web Services Key Management Service Developer Guide.
" + "smithy.api#documentation": "The Amazon Resource Name (ARN) of a Amazon Web Services Key Management Service key that\n SageMaker uses to encrypt data on the storage volume attached to your notebook instance. The\n KMS key you provide must be enabled. For information, see Enabling and Disabling\n Keys in the Amazon Web Services Key Management Service Developer\n Guide.
" } }, "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } }, "LifecycleConfigName": { @@ -7076,13 +7076,13 @@ "DefaultCodeRepository": { "target": "com.amazonaws.sagemaker#CodeRepositoryNameOrUrl", "traits": { - "smithy.api#documentation": "A Git repository to associate with the notebook instance as its default code\n repository. This can be either the name of a Git repository stored as a resource in your\n account, or the URL of a Git repository in Amazon Web Services CodeCommit or in any\n other Git repository. When you open a notebook instance, it opens in the directory that\n contains this repository. For more information, see Associating Git Repositories with SageMaker\n Notebook Instances.
" + "smithy.api#documentation": "A Git repository to associate with the notebook instance as its default code\n repository. This can be either the name of a Git repository stored as a resource in your\n account, or the URL of a Git repository in Amazon Web Services CodeCommit\n or in any other Git repository. When you open a notebook instance, it opens in the\n directory that contains this repository. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" } }, "AdditionalCodeRepositories": { "target": "com.amazonaws.sagemaker#AdditionalCodeRepositoryNamesOrUrls", "traits": { - "smithy.api#documentation": "An array of up to three Git repositories to associate with the notebook instance.\n These can be either the names of Git repositories stored as resources in your account,\n or the URL of Git repositories in Amazon Web Services CodeCommit or in any\n other Git repository. These repositories are cloned at the same level as the default\n repository of your notebook instance. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" + "smithy.api#documentation": "An array of up to three Git repositories to associate with the notebook instance.\n These can be either the names of Git repositories stored as resources in your account,\n or the URL of Git repositories in Amazon Web Services CodeCommit\n or in any other Git repository. These repositories are cloned at the same level as the\n default repository of your notebook instance. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" } }, "RootAccess": { @@ -7330,7 +7330,7 @@ "target": "com.amazonaws.sagemaker#CreatePresignedNotebookInstanceUrlOutput" }, "traits": { - "smithy.api#documentation": "Returns a URL that you can use to connect to the Jupyter server from a notebook\n instance. In the SageMaker console, when you choose Open
next to a notebook\n instance, SageMaker opens a new tab showing the Jupyter server home page from the notebook\n instance. The console uses this API to get the URL and show the page.
The IAM role or user used to call this API defines the permissions to access the\n notebook instance. Once the presigned URL is created, no additional permission is\n required to access this URL. IAM authorization policies for this API are also enforced\n for every HTTP request and WebSocket frame that attempts to connect to the notebook\n instance.
\nYou can restrict access to this API and to the URL that it returns to a list of IP\n addresses that you specify. Use the NotIpAddress
condition operator and the\n aws:SourceIP
condition context key to specify the list of IP addresses\n that you want to have access to the notebook instance. For more information, see Limit Access to a Notebook Instance by IP Address.
The URL that you get from a call to CreatePresignedNotebookInstanceUrl is valid only for 5 minutes. If\n you try to use the URL after the 5-minute limit expires, you are directed to the\n Amazon Web Services console sign-in page.
\nReturns a URL that you can use to connect to the Jupyter server from a notebook\n instance. In the SageMaker console, when you choose Open
next to a notebook\n instance, SageMaker opens a new tab showing the Jupyter server home page from the notebook\n instance. The console uses this API to get the URL and show the page.
The IAM role or user used to call this API defines the permissions to access the\n notebook instance. Once the presigned URL is created, no additional permission is\n required to access this URL. IAM authorization policies for this API are also enforced\n for every HTTP request and WebSocket frame that attempts to connect to the notebook\n instance.
\nYou can restrict access to this API and to the URL that it returns to a list of IP\n addresses that you specify. Use the NotIpAddress
condition operator and the\n aws:SourceIP
condition context key to specify the list of IP addresses\n that you want to have access to the notebook instance. For more information, see Limit Access to a Notebook Instance by IP Address.
The URL that you get from a call to CreatePresignedNotebookInstanceUrl is valid only for 5 minutes. If\n you try to use the URL after the 5-minute limit expires, you are directed to the\n Amazon Web Services console sign-in page.
\nThe name of the training job. The name must be unique within an Amazon Web Services Region in an\n Amazon Web Services account.
", + "smithy.api#documentation": "The name of the training job. The name must be unique within an Amazon Web Services\n Region in an Amazon Web Services account.
", "smithy.api#required": {} } }, @@ -7652,7 +7652,7 @@ "InputDataConfig": { "target": "com.amazonaws.sagemaker#InputDataConfig", "traits": { - "smithy.api#documentation": "An array of Channel
objects. Each channel is a named input source.\n InputDataConfig
describes the input data and its location.
Algorithms can accept input data from one or more channels. For example, an\n algorithm might have two channels of input data, training_data
and\n validation_data
. The configuration for each channel provides the S3,\n EFS, or FSx location where the input data is stored. It also provides information about\n the stored data: the MIME type, compression method, and whether the data is wrapped in\n RecordIO format.
Depending on the input mode that the algorithm supports, SageMaker either copies input\n data files from an S3 bucket to a local directory in the Docker container, or makes it\n available as input streams. For example, if you specify an EFS location, input data\n files are available as input streams. They do not need to be\n downloaded.
" + "smithy.api#documentation": "An array of Channel
objects. Each channel is a named input source.\n InputDataConfig
describes the input data and its location.
Algorithms can accept input data from one or more channels. For example, an\n algorithm might have two channels of input data, training_data
and\n validation_data
. The configuration for each channel provides the S3,\n EFS, or FSx location where the input data is stored. It also provides information about\n the stored data: the MIME type, compression method, and whether the data is wrapped in\n RecordIO format.
Depending on the input mode that the algorithm supports, SageMaker either copies input\n data files from an S3 bucket to a local directory in the Docker container, or makes it\n available as input streams. For example, if you specify an EFS location, input data\n files are available as input streams. They do not need to be downloaded.
" } }, "OutputDataConfig": { @@ -7685,7 +7685,7 @@ "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } }, "EnableNetworkIsolation": { @@ -9319,7 +9319,7 @@ "target": "smithy.api#Unit" }, "traits": { - "smithy.api#documentation": "Deletes an endpoint. SageMaker frees up all of the resources that were deployed when the\n endpoint was created.
\nSageMaker retires any custom KMS key grants associated with the endpoint, meaning you don't\n need to use the RevokeGrant API call.
\nWhen you delete your endpoint, SageMaker asynchronously deletes associated endpoint resources such as KMS key grants.\n You might still see these resources in your account for a few minutes after deleting your endpoint.\n Do not delete or revoke the permissions for your\n \n ExecutionRoleArn\n
,\n otherwise SageMaker cannot delete these resources.
Deletes an endpoint. SageMaker frees up all of the resources that were deployed when the\n endpoint was created.
\nSageMaker retires any custom KMS key grants associated with the endpoint, meaning you don't\n need to use the RevokeGrant API call.
\nWhen you delete your endpoint, SageMaker asynchronously deletes associated endpoint\n resources such as KMS key grants. You might still see these resources in your account\n for a few minutes after deleting your endpoint. Do not delete or revoke the permissions\n for your \n ExecutionRoleArn\n
, otherwise SageMaker cannot delete these\n resources.
Deletes a model. The DeleteModel
API deletes only the model entry that\n was created in SageMaker when you called the CreateModel
API. It does not\n delete model artifacts, inference code, or the IAM role that you specified when\n creating the model.
Deletes a model. The DeleteModel
API deletes only the model entry that\n was created in SageMaker when you called the CreateModel
API. It does not delete\n model artifacts, inference code, or the IAM role that you specified when creating the\n model.
Automatic rollback configuration for handling endpoint deployment failures and recovery.
" + "smithy.api#documentation": "Automatic rollback configuration for handling endpoint deployment failures and\n recovery.
" } } }, @@ -10544,7 +10544,7 @@ "CertifyForMarketplace": { "target": "com.amazonaws.sagemaker#CertifyForMarketplace", "traits": { - "smithy.api#documentation": "Whether the algorithm is certified to be listed in Amazon Web Services Marketplace.
" + "smithy.api#documentation": "Whether the algorithm is certified to be listed in Amazon Web Services\n Marketplace.
" } } } @@ -11052,7 +11052,7 @@ "GitConfig": { "target": "com.amazonaws.sagemaker#GitConfig", "traits": { - "smithy.api#documentation": "Configuration details about the repository, including the URL where the repository is\n located, the default branch, and the Amazon Resource Name (ARN) of the Amazon Web Services Secrets\n Manager secret that contains the credentials used to access the repository.
" + "smithy.api#documentation": "Configuration details about the repository, including the URL where the repository is\n located, the default branch, and the Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret that contains the credentials used to access the\n repository.
" } } } @@ -11750,13 +11750,13 @@ "AppSecurityGroupManagement": { "target": "com.amazonaws.sagemaker#AppSecurityGroupManagement", "traits": { - "smithy.api#documentation": "The entity that creates and manages the required security groups for inter-app communication in VPCOnly
mode. \n Required when CreateDomain.AppNetworkAccessType
is VPCOnly
and DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is provided.
The entity that creates and manages the required security groups for inter-app\n communication in VPCOnly
mode. Required when\n CreateDomain.AppNetworkAccessType
is VPCOnly
and\n DomainSettings.RStudioServerProDomainSettings.DomainExecutionRoleArn
is\n provided.
The ID of the security group that authorizes traffic between the RSessionGateway
apps and the RStudioServerPro
app.
The ID of the security group that authorizes traffic between the\n RSessionGateway
apps and the RStudioServerPro
app.
Amazon Web Services KMS key ID Amazon SageMaker uses to encrypt data when storing it on the ML storage\n volume attached to the instance.
" + "smithy.api#documentation": "Amazon Web Services KMS key ID Amazon SageMaker uses to encrypt data when storing it on\n the ML storage volume attached to the instance.
" } }, "CreationTime": { @@ -12141,7 +12141,7 @@ "AsyncInferenceConfig": { "target": "com.amazonaws.sagemaker#AsyncInferenceConfig", "traits": { - "smithy.api#documentation": "Returns the description of an endpoint configuration created using the \n \n CreateEndpointConfig
\n API.
Returns the description of an endpoint configuration created using the \n CreateEndpointConfig
\n API.
Returns the description of an endpoint configuration created \n using the \n CreateEndpointConfig
\n API.
Returns the description of an endpoint configuration created using the \n CreateEndpointConfig
\n API.
The location of the job's output data and the Amazon Web Services Key Management Service key ID for the key used to\n encrypt the output data, if any.
", + "smithy.api#documentation": "The location of the job's output data and the Amazon Web Services Key Management\n Service key ID for the key used to encrypt the output data, if any.
", "smithy.api#required": {} } }, @@ -13470,7 +13470,7 @@ "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } }, "LabelingJobOutput": { @@ -14522,7 +14522,7 @@ "KmsKeyId": { "target": "com.amazonaws.sagemaker#KmsKeyId", "traits": { - "smithy.api#documentation": "The Amazon Web Services KMS key ID SageMaker uses to encrypt data when storing it on the ML storage\n volume attached to the instance.
" + "smithy.api#documentation": "The Amazon Web Services KMS key ID SageMaker uses to encrypt data when storing it on the\n ML storage volume attached to the instance.
" } }, "NetworkInterfaceId": { @@ -14570,13 +14570,13 @@ "DefaultCodeRepository": { "target": "com.amazonaws.sagemaker#CodeRepositoryNameOrUrl", "traits": { - "smithy.api#documentation": "The Git repository associated with the notebook instance as its default code\n repository. This can be either the name of a Git repository stored as a resource in your\n account, or the URL of a Git repository in Amazon Web Services CodeCommit or in any\n other Git repository. When you open a notebook instance, it opens in the directory that\n contains this repository. For more information, see Associating Git Repositories with SageMaker\n Notebook Instances.
" + "smithy.api#documentation": "The Git repository associated with the notebook instance as its default code\n repository. This can be either the name of a Git repository stored as a resource in your\n account, or the URL of a Git repository in Amazon Web Services CodeCommit\n or in any other Git repository. When you open a notebook instance, it opens in the\n directory that contains this repository. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" } }, "AdditionalCodeRepositories": { "target": "com.amazonaws.sagemaker#AdditionalCodeRepositoryNamesOrUrls", "traits": { - "smithy.api#documentation": "An array of up to three Git repositories associated with the notebook instance. These\n can be either the names of Git repositories stored as resources in your account, or the\n URL of Git repositories in Amazon Web Services CodeCommit or in any\n other Git repository. These repositories are cloned at the same level as the default\n repository of your notebook instance. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" + "smithy.api#documentation": "An array of up to three Git repositories associated with the notebook instance. These\n can be either the names of Git repositories stored as resources in your account, or the\n URL of Git repositories in Amazon Web Services CodeCommit\n or in any other Git repository. These repositories are cloned at the same level as the\n default repository of your notebook instance. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" } }, "RootAccess": { @@ -15414,7 +15414,7 @@ "RoleArn": { "target": "com.amazonaws.sagemaker#RoleArn", "traits": { - "smithy.api#documentation": "The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.
" + "smithy.api#documentation": "The Amazon Web Services Identity and Access Management (IAM) role configured for\n the training job.
" } }, "InputDataConfig": { @@ -16911,18 +16911,18 @@ "SecurityGroupIds": { "target": "com.amazonaws.sagemaker#DomainSecurityGroupIds", "traits": { - "smithy.api#documentation": "The security groups for the Amazon Virtual Private Cloud that the Domain
uses for communication between Domain-level apps and user apps.
The security groups for the Amazon Virtual Private Cloud that the Domain
uses for\n communication between Domain-level apps and user apps.
A collection of settings that configure the RStudioServerPro
Domain-level app.
A collection of settings that configure the RStudioServerPro
Domain-level\n app.
A collection of settings that apply to the SageMaker Domain
. These settings are specified through the CreateDomain
API call.
A collection of settings that apply to the SageMaker Domain
. These\n settings are specified through the CreateDomain
API call.
A collection of RStudioServerPro
Domain-level app settings to update.
A collection of RStudioServerPro
Domain-level app settings to\n update.
A list of the tags associated with the endpoint. For more information, see Tagging Amazon Web Services\n resources in the Amazon Web Services General Reference Guide.
" + "smithy.api#documentation": "A list of the tags associated with the endpoint. For more information, see Tagging Amazon Web Services resources in the Amazon Web Services General\n Reference Guide.
" } } }, @@ -19780,12 +19780,12 @@ "SecretArn": { "target": "com.amazonaws.sagemaker#SecretArn", "traits": { - "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret that contains the\n credentials used to access the git repository. The secret must have a staging label of\n AWSCURRENT
and must be in the following format:
\n {\"username\": UserName, \"password\":\n Password}
\n
The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret that\n contains the credentials used to access the git repository. The secret must have a\n staging label of AWSCURRENT
and must be in the following format:
\n {\"username\": UserName, \"password\":\n Password}
\n
Specifies configuration details for a Git repository in your Amazon Web Services account.
" + "smithy.api#documentation": "Specifies configuration details for a Git repository in your Amazon Web Services\n account.
" } }, "com.amazonaws.sagemaker#GitConfigForUpdate": { @@ -19794,7 +19794,7 @@ "SecretArn": { "target": "com.amazonaws.sagemaker#SecretArn", "traits": { - "smithy.api#documentation": "The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret that contains the\n credentials used to access the git repository. The secret must have a staging label of\n AWSCURRENT
and must be in the following format:
\n {\"username\": UserName, \"password\":\n Password}
\n
The Amazon Resource Name (ARN) of the Amazon Web Services Secrets Manager secret that\n contains the credentials used to access the git repository. The secret must have a\n staging label of AWSCURRENT
and must be in the following format:
\n {\"username\": UserName, \"password\":\n Password}
\n
The resources,\n including\n the compute instances and storage volumes, to use for the training\n jobs that the tuning job launches.
\nStorage volumes store model artifacts and\n incremental\n states. Training algorithms might also use storage volumes for\n scratch\n space. If you want SageMaker to use the storage volume to store the\n training data, choose File
as the TrainingInputMode
in the\n algorithm specification. For distributed training algorithms, specify an instance count\n greater than 1.
The resources,\n including\n the compute instances and storage volumes, to use for the training\n jobs that the tuning job launches.
\nStorage volumes store model artifacts and\n incremental\n states. Training algorithms might also use storage volumes for\n scratch\n space. If you want SageMaker to use the storage volume to store the\n training data, choose File
as the TrainingInputMode
in the\n algorithm specification. For distributed training algorithms, specify an instance count\n greater than 1.
If you want to use hyperparameter optimization with instance type flexibility, use HyperParameterTuningResourceConfig
instead.
The number of times to retry the job when the job fails due to an\n InternalServerError
.
The configuration for the hyperparameter tuning resources, including the compute\n instances and storage volumes, used for training jobs launched by the tuning job. By\n default, storage volumes hold model artifacts and incremental states. Choose\n File
for TrainingInputMode
in the\n AlgorithmSpecification
parameter to additionally store training data in\n the storage volume (optional).
The container for the summary information about a training job.
" } }, + "com.amazonaws.sagemaker#HyperParameterTuningAllocationStrategy": { + "type": "string", + "traits": { + "smithy.api#enum": [ + { + "value": "Prioritized", + "name": "PRIORITIZED" + } + ] + } + }, + "com.amazonaws.sagemaker#HyperParameterTuningInstanceConfig": { + "type": "structure", + "members": { + "InstanceType": { + "target": "com.amazonaws.sagemaker#TrainingInstanceType", + "traits": { + "smithy.api#documentation": "The instance type used for processing of hyperparameter optimization jobs. Choose from\n general purpose (no GPUs) instance types: ml.m5.xlarge, ml.m5.2xlarge, and ml.m5.4xlarge\n or compute optimized (no GPUs) instance types: ml.c5.xlarge and ml.c5.2xlarge. For more\n information about instance types, see instance type\n descriptions.
", + "smithy.api#required": {} + } + }, + "InstanceCount": { + "target": "com.amazonaws.sagemaker#TrainingInstanceCount", + "traits": { + "smithy.api#documentation": "The number of instances of the type specified by InstanceType
. Choose an\n instance count larger than 1 for distributed training algorithms. See SageMaker distributed training\n jobs for more information.
The volume size in GB of the data to be processed for hyperparameter optimization\n (optional).
", + "smithy.api#required": {} + } + } + }, + "traits": { + "smithy.api#documentation": "The configuration for hyperparameter tuning resources for use in training jobs\n launched by the tuning job. These resources include compute instances and storage\n volumes. Specify one or more compute instance configurations and allocation strategies\n to select resources (optional).
" + } + }, + "com.amazonaws.sagemaker#HyperParameterTuningInstanceConfigs": { + "type": "list", + "member": { + "target": "com.amazonaws.sagemaker#HyperParameterTuningInstanceConfig" + }, + "traits": { + "smithy.api#length": { + "min": 1, + "max": 6 + } + } + }, "com.amazonaws.sagemaker#HyperParameterTuningJobArn": { "type": "string", "traits": { @@ -20743,6 +20800,50 @@ ] } }, + "com.amazonaws.sagemaker#HyperParameterTuningResourceConfig": { + "type": "structure", + "members": { + "InstanceType": { + "target": "com.amazonaws.sagemaker#TrainingInstanceType", + "traits": { + "smithy.api#documentation": "The instance type used to run hyperparameter optimization tuning jobs. See descriptions of\n instance types for more information.
" + } + }, + "InstanceCount": { + "target": "com.amazonaws.sagemaker#TrainingInstanceCount", + "traits": { + "smithy.api#documentation": "The number of compute instances of type InstanceType
to use. For distributed training, select a value greater than 1.
The volume size in GB for the storage volume to be used in processing hyperparameter\n optimization jobs (optional). These volumes store model artifacts, incremental states\n and optionally, scratch space for training algorithms. Do not provide a value for this\n parameter if a value for InstanceConfigs
is also specified.
Some instance types have a fixed total local storage size. If you select one of these\n instances for training, VolumeSizeInGB
cannot be greater than this total\n size. For a list of instance types with local instance storage and their sizes, see\n instance store volumes.
SageMaker supports only the General Purpose SSD (gp2) storage volume type.
\nA key used by AWS Key Management Service to encrypt data on the storage volume attached to the compute\n instances used to run the training job. You can use either of the following formats to\n specify a key.
\nKMS Key ID:
\n\n \"1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
Amazon Resource Name (ARN) of a AWS KMS key:
\n\n \"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
Some instances use local storage, which use a hardware module to encrypt storage volumes. If you choose one of these\n instance types, you cannot request a VolumeKmsKeyId
. For a list of instance\n types that use local storage, see instance store volumes. For more information about AWS Key Management Service, see AWS KMS encryption for more information.
The strategy that determines the order of preference for resources specified in\n InstanceConfigs
used in hyperparameter optimization.
A list containing the configuration(s) for one or more resources for processing\n hyperparameter jobs. These resources include compute instances and storage volumes to\n use in model training jobs launched by hyperparameter tuning jobs. The\n AllocationStrategy
controls the order in which multiple configurations\n provided in InstanceConfigs
are used.
If you only want to use a single InstanceConfig inside the\n HyperParameterTuningResourceConfig
API, do not provide a value for\n InstanceConfigs
. Instead, use InstanceType
,\n VolumeSizeInGB
and InstanceCount
. If you use\n InstanceConfigs
, do not provide values for\n InstanceType
, VolumeSizeInGB
or\n InstanceCount
.
The configuration of resources, including compute instances and storage volumes for\n use in training jobs launched by hyperparameter tuning jobs. Specify one or more\n instance type and count and the allocation strategy for instance selection.
\nHyperParameterTuningResourceConfig supports all of the capabilities of\n ResourceConfig with added functionality for flexible instance management.
\nDefines an instance group for heterogeneous cluster training. \n When requesting a training job using the CreateTrainingJob API, \n you can configure multiple instance groups .
" + "smithy.api#documentation": "Defines an instance group for heterogeneous cluster training. When requesting a\n training job using the CreateTrainingJob API, you can configure multiple instance groups .
" } }, "com.amazonaws.sagemaker#InstanceGroupName": { @@ -22347,7 +22448,7 @@ "WorkRequesterAccountId": { "target": "com.amazonaws.sagemaker#AccountId", "traits": { - "smithy.api#documentation": "The Amazon Web Services account ID of the account used to start the labeling job.
", + "smithy.api#documentation": "The Amazon Web Services account ID of the account used to start the labeling\n job.
", "smithy.api#required": {} } }, @@ -23658,7 +23759,7 @@ "CodeRepositorySummaryList": { "target": "com.amazonaws.sagemaker#CodeRepositorySummaryList", "traits": { - "smithy.api#documentation": "Gets a list of summaries of the Git repositories. Each summary specifies the following\n values for the repository:
\nName
\nAmazon Resource Name (ARN)
\nCreation time
\nLast modified time
\nConfiguration information, including the URL location of the repository and\n the ARN of the Amazon Web Services Secrets Manager secret that contains the credentials used\n to access the repository.
\nGets a list of summaries of the Git repositories. Each summary specifies the following\n values for the repository:
\nName
\nAmazon Resource Name (ARN)
\nCreation time
\nLast modified time
\nConfiguration information, including the URL location of the repository and\n the ARN of the Amazon Web Services Secrets Manager secret that contains the\n credentials used to access the repository.
\nA string in the model name. This filter returns only models whose \n name contains the specified string.
" + "smithy.api#documentation": "A string in the model name. This filter returns only models whose name contains the\n specified string.
" } }, "CreationTimeBefore": { @@ -26624,7 +26725,7 @@ "target": "com.amazonaws.sagemaker#ListNotebookInstancesOutput" }, "traits": { - "smithy.api#documentation": "Returns a list of the SageMaker notebook instances in the requester's account in an Amazon Web Services\n Region.
", + "smithy.api#documentation": "Returns a list of the SageMaker notebook instances in the requester's account in an\n Amazon Web Services Region.
", "smithy.api#paginated": { "inputToken": "NextToken", "outputToken": "NextToken", @@ -27536,7 +27637,7 @@ "target": "com.amazonaws.sagemaker#ListTrainingJobsResponse" }, "traits": { - "smithy.api#documentation": "Lists training jobs.
\nWhen StatusEquals
and MaxResults
are set at the same\n time, the MaxResults
number of training jobs are first retrieved\n ignoring the StatusEquals
parameter and then they are filtered by the\n StatusEquals
parameter, which is returned as a response.
For example, if ListTrainingJobs
is invoked with the following\n parameters:
\n { ... MaxResults: 100, StatusEquals: InProgress ... }
\n
First, 100 trainings jobs with any status, including those other than\n InProgress
, are selected (sorted according to the creation time,\n from the most current to the oldest). Next, those with a status of\n InProgress
are returned.
You can quickly test the API using the following Amazon Web Services CLI code.
\n\n aws sagemaker list-training-jobs --max-results 100 --status-equals\n InProgress
\n
Lists training jobs.
\nWhen StatusEquals
and MaxResults
are set at the same\n time, the MaxResults
number of training jobs are first retrieved\n ignoring the StatusEquals
parameter and then they are filtered by the\n StatusEquals
parameter, which is returned as a response.
For example, if ListTrainingJobs
is invoked with the following\n parameters:
\n { ... MaxResults: 100, StatusEquals: InProgress ... }
\n
First, 100 trainings jobs with any status, including those other than\n InProgress
, are selected (sorted according to the creation time,\n from the most current to the oldest). Next, those with a status of\n InProgress
are returned.
You can quickly test the API using the following Amazon Web Services CLI\n code.
\n\n aws sagemaker list-training-jobs --max-results 100 --status-equals\n InProgress
\n
The timeout value in seconds for an invocation request. The default value is 600.
" + "smithy.api#documentation": "The timeout value in seconds for an invocation request. The default value is\n 600.
" } }, "InvocationsMaxRetries": { "target": "com.amazonaws.sagemaker#InvocationsMaxRetries", "traits": { - "smithy.api#documentation": "The maximum number of retries when invocation requests are failing. The default value is 3.
" + "smithy.api#documentation": "The maximum number of retries when invocation requests are failing. The default value\n is 3.
" } } }, @@ -31421,13 +31522,13 @@ "DefaultCodeRepository": { "target": "com.amazonaws.sagemaker#CodeRepositoryNameOrUrl", "traits": { - "smithy.api#documentation": "The Git repository associated with the notebook instance as its default code\n repository. This can be either the name of a Git repository stored as a resource in your\n account, or the URL of a Git repository in Amazon Web Services CodeCommit or in any\n other Git repository. When you open a notebook instance, it opens in the directory that\n contains this repository. For more information, see Associating Git Repositories with SageMaker\n Notebook Instances.
" + "smithy.api#documentation": "The Git repository associated with the notebook instance as its default code\n repository. This can be either the name of a Git repository stored as a resource in your\n account, or the URL of a Git repository in Amazon Web Services CodeCommit\n or in any other Git repository. When you open a notebook instance, it opens in the\n directory that contains this repository. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" } }, "AdditionalCodeRepositories": { "target": "com.amazonaws.sagemaker#AdditionalCodeRepositoryNamesOrUrls", "traits": { - "smithy.api#documentation": "An array of up to three Git repositories associated with the notebook instance. These\n can be either the names of Git repositories stored as resources in your account, or the\n URL of Git repositories in Amazon Web Services CodeCommit or in any\n other Git repository. These repositories are cloned at the same level as the default\n repository of your notebook instance. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" + "smithy.api#documentation": "An array of up to three Git repositories associated with the notebook instance. These\n can be either the names of Git repositories stored as resources in your account, or the\n URL of Git repositories in Amazon Web Services CodeCommit\n or in any other Git repository. These repositories are cloned at the same level as the\n default repository of your notebook instance. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" } } }, @@ -31925,7 +32026,7 @@ "KmsKeyId": { "target": "com.amazonaws.sagemaker#KmsKeyId", "traits": { - "smithy.api#documentation": "The Amazon Web Services Key Management Service (Amazon Web Services KMS) key that SageMaker uses to encrypt the model artifacts at rest using\n Amazon S3 server-side encryption. The KmsKeyId
can be any of the following\n formats:
// KMS Key ID
\n\n \"1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// Amazon Resource Name (ARN) of a KMS Key
\n\n \"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// KMS Key Alias
\n\n \"alias/ExampleAlias\"
\n
// Amazon Resource Name (ARN) of a KMS Key Alias
\n\n \"arn:aws:kms:us-west-2:111122223333:alias/ExampleAlias\"
\n
If you use a KMS key ID or an alias of your KMS key, the SageMaker execution role must\n include permissions to call kms:Encrypt
. If you don't provide a KMS key ID,\n SageMaker uses the default KMS key for Amazon S3 for your role's account. SageMaker uses server-side\n encryption with KMS-managed keys for OutputDataConfig
. If you use a bucket\n policy with an s3:PutObject
permission that only allows objects with\n server-side encryption, set the condition key of\n s3:x-amz-server-side-encryption
to \"aws:kms\"
. For more\n information, see KMS-Managed Encryption\n Keys in the Amazon Simple Storage Service Developer Guide.\n
The KMS key policy must grant permission to the IAM role that you specify in your\n CreateTrainingJob
, CreateTransformJob
, or\n CreateHyperParameterTuningJob
requests. For more information, see\n Using\n Key Policies in Amazon Web Services KMS in the Amazon Web Services Key Management Service Developer\n Guide.
The Amazon Web Services Key Management Service (Amazon Web Services KMS) key that SageMaker\n uses to encrypt the model artifacts at rest using Amazon S3 server-side encryption. The\n KmsKeyId
can be any of the following formats:
// KMS Key ID
\n\n \"1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// Amazon Resource Name (ARN) of a KMS Key
\n\n \"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// KMS Key Alias
\n\n \"alias/ExampleAlias\"
\n
// Amazon Resource Name (ARN) of a KMS Key Alias
\n\n \"arn:aws:kms:us-west-2:111122223333:alias/ExampleAlias\"
\n
If you use a KMS key ID or an alias of your KMS key, the SageMaker execution role must\n include permissions to call kms:Encrypt
. If you don't provide a KMS key ID,\n SageMaker uses the default KMS key for Amazon S3 for your role's account. SageMaker uses server-side\n encryption with KMS-managed keys for OutputDataConfig
. If you use a bucket\n policy with an s3:PutObject
permission that only allows objects with\n server-side encryption, set the condition key of\n s3:x-amz-server-side-encryption
to \"aws:kms\"
. For more\n information, see KMS-Managed Encryption\n Keys in the Amazon Simple Storage Service Developer Guide.\n
The KMS key policy must grant permission to the IAM role that you specify in your\n CreateTrainingJob
, CreateTransformJob
, or\n CreateHyperParameterTuningJob
requests. For more information, see\n Using\n Key Policies in Amazon Web Services KMS in the Amazon Web Services\n Key Management Service Developer Guide.
Specifies ranges of integer, continuous, and categorical hyperparameters that a\n hyperparameter tuning job searches. The hyperparameter tuning job launches training jobs\n with hyperparameter values within these ranges to find the combination of values that\n result in the training job with the best performance as measured by the objective metric\n of the hyperparameter tuning job.
\nThe maximum number of items specified for Array Members
refers to\n the maximum number of hyperparameters for each range and also the maximum for the\n hyperparameter tuning job itself. That is, the sum of the number of hyperparameters\n for all the ranges can't exceed the maximum number specified.
Specifies ranges of integer, continuous, and categorical hyperparameters that a\n hyperparameter tuning job searches. The hyperparameter tuning job launches training jobs\n with hyperparameter values within these ranges to find the combination of values that\n result in the training job with the best performance as measured by the objective metric\n of the hyperparameter tuning job.
\nThe maximum number of items specified for Array Members
refers to the\n maximum number of hyperparameters for each range and also the maximum for the\n hyperparameter tuning job itself. That is, the sum of the number of hyperparameters\n for all the ranges can't exceed the maximum number specified.
The summary of an in-progress deployment when an endpoint is creating or\n updating with a new endpoint configuration.
" + "smithy.api#documentation": "The summary of an in-progress deployment when an endpoint is creating or updating with\n a new endpoint configuration.
" } }, "com.amazonaws.sagemaker#PendingProductionVariantSummary": { @@ -32242,7 +32343,7 @@ "DeployedImages": { "target": "com.amazonaws.sagemaker#DeployedImages", "traits": { - "smithy.api#documentation": "An array of DeployedImage
objects that specify the Amazon EC2\n Container Registry paths of the inference images deployed on instances of this\n ProductionVariant
.
An array of DeployedImage
objects that specify the Amazon EC2 Container\n Registry paths of the inference images deployed on instances of this\n ProductionVariant
.
The requested weight for the variant in this deployment, as specified in the endpoint configuration\n for the endpoint. The value is taken from the request to the \n CreateEndpointConfig\n
operation.
The requested weight for the variant in this deployment, as specified in the endpoint\n configuration for the endpoint. The value is taken from the request to the \n CreateEndpointConfig\n
operation.
The number of instances requested in this deployment, as specified in the endpoint configuration\n for the endpoint. The value is taken from the request to the \n CreateEndpointConfig\n
operation.
The number of instances requested in this deployment, as specified in the endpoint\n configuration for the endpoint. The value is taken from the request to the \n CreateEndpointConfig\n
operation.
The size of the Elastic Inference (EI) instance to use for the production variant. EI\n instances provide on-demand GPU computing for inference. For more information, see\n Using Elastic\n Inference in Amazon SageMaker.
" + "smithy.api#documentation": "The size of the Elastic Inference (EI) instance to use for the production variant. EI\n instances provide on-demand GPU computing for inference. For more information, see\n Using Elastic\n Inference in Amazon SageMaker.
" } }, "VariantStatus": { "target": "com.amazonaws.sagemaker#ProductionVariantStatusList", "traits": { - "smithy.api#documentation": "The endpoint variant status which describes the current deployment stage status or operational status.
" + "smithy.api#documentation": "The endpoint variant status which describes the current deployment stage status or\n operational status.
" } }, "CurrentServerlessConfig": { @@ -32301,7 +32402,7 @@ } }, "traits": { - "smithy.api#documentation": "The production variant summary for a deployment when an endpoint is\n creating or updating with the \n CreateEndpoint\n
\n or \n UpdateEndpoint\n
operations.\n Describes the VariantStatus
, weight and capacity for a production\n variant associated with an endpoint.\n
The production variant summary for a deployment when an endpoint is creating or\n updating with the \n CreateEndpoint\n
or \n UpdateEndpoint\n
operations. Describes the VariantStatus\n
, weight and capacity for a production variant associated with an endpoint.\n
The Amazon Web Services Key Management Service (Amazon Web Services KMS) key that SageMaker uses to encrypt the core dump data at rest using\n Amazon S3 server-side encryption. The KmsKeyId
can be any of the following\n formats:
// KMS Key ID
\n\n \"1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// Amazon Resource Name (ARN) of a KMS Key
\n\n \"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// KMS Key Alias
\n\n \"alias/ExampleAlias\"
\n
// Amazon Resource Name (ARN) of a KMS Key Alias
\n\n \"arn:aws:kms:us-west-2:111122223333:alias/ExampleAlias\"
\n
If you use a KMS key ID or an alias of your KMS key, the SageMaker execution role must\n include permissions to call kms:Encrypt
. If you don't provide a KMS key ID,\n SageMaker uses the default KMS key for Amazon S3 for your role's account. SageMaker uses server-side\n encryption with KMS-managed keys for OutputDataConfig
. If you use a bucket\n policy with an s3:PutObject
permission that only allows objects with\n server-side encryption, set the condition key of\n s3:x-amz-server-side-encryption
to \"aws:kms\"
. For more\n information, see KMS-Managed Encryption\n Keys in the Amazon Simple Storage Service Developer Guide.\n
The KMS key policy must grant permission to the IAM role that you specify in your\n CreateEndpoint
and UpdateEndpoint
requests. For more\n information, see Using Key Policies in Amazon Web Services\n KMS in the Amazon Web Services Key Management Service Developer Guide.
The Amazon Web Services Key Management Service (Amazon Web Services KMS) key that SageMaker\n uses to encrypt the core dump data at rest using Amazon S3 server-side encryption. The\n KmsKeyId
can be any of the following formats:
// KMS Key ID
\n\n \"1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// Amazon Resource Name (ARN) of a KMS Key
\n\n \"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// KMS Key Alias
\n\n \"alias/ExampleAlias\"
\n
// Amazon Resource Name (ARN) of a KMS Key Alias
\n\n \"arn:aws:kms:us-west-2:111122223333:alias/ExampleAlias\"
\n
If you use a KMS key ID or an alias of your KMS key, the SageMaker execution role must\n include permissions to call kms:Encrypt
. If you don't provide a KMS key ID,\n SageMaker uses the default KMS key for Amazon S3 for your role's account. SageMaker uses server-side\n encryption with KMS-managed keys for OutputDataConfig
. If you use a bucket\n policy with an s3:PutObject
permission that only allows objects with\n server-side encryption, set the condition key of\n s3:x-amz-server-side-encryption
to \"aws:kms\"
. For more\n information, see KMS-Managed Encryption\n Keys in the Amazon Simple Storage Service Developer Guide.\n
The KMS key policy must grant permission to the IAM role that you specify in your\n CreateEndpoint
and UpdateEndpoint
requests. For more\n information, see Using Key Policies in Amazon Web Services KMS in the Amazon Web Services Key Management\n Service Developer Guide.
The endpoint variant status which describes the current deployment stage status or operational status.
\n\n Creating
: Creating inference resources for the production variant.
\n Deleting
: Terminating inference resources for the production variant.
\n Updating
: Updating capacity for the production variant.
\n ActivatingTraffic
: Turning on traffic for the production variant.
\n Baking
: Waiting period to monitor the CloudWatch alarms in the\n automatic rollback configuration.
The endpoint variant status which describes the current deployment stage status or\n operational status.
\n\n Creating
: Creating inference resources for the production\n variant.
\n Deleting
: Terminating inference resources for the production\n variant.
\n Updating
: Updating capacity for the production variant.
\n ActivatingTraffic
: Turning on traffic for the production\n variant.
\n Baking
: Waiting period to monitor the CloudWatch alarms in the\n automatic rollback configuration.
The endpoint variant status which describes the current deployment stage status or operational status.
" + "smithy.api#documentation": "The endpoint variant status which describes the current deployment stage status or\n operational status.
" } }, "CurrentServerlessConfig": { @@ -34757,7 +34858,7 @@ "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } }, "LastModifiedTime": { @@ -35407,18 +35508,18 @@ "AccessStatus": { "target": "com.amazonaws.sagemaker#RStudioServerProAccessStatus", "traits": { - "smithy.api#documentation": "Indicates whether the current user has access to the RStudioServerPro
app.
Indicates whether the current user has access to the RStudioServerPro
\n app.
The level of permissions that the user has within the RStudioServerPro
app. This value defaults to `User`. The `Admin` value allows the user access to the RStudio Administrative Dashboard.
The level of permissions that the user has within the RStudioServerPro
\n app. This value defaults to `User`. The `Admin` value allows the user access to the\n RStudio Administrative Dashboard.
A collection of settings that configure user interaction with the RStudioServerPro
app. RStudioServerProAppSettings
cannot be updated. The RStudioServerPro
app must be deleted and a new one created to make any changes.
A collection of settings that configure user interaction with the\n RStudioServerPro
app. RStudioServerProAppSettings
cannot\n be updated. The RStudioServerPro
app must be deleted and a new one created\n to make any changes.
The ARN of the execution role for the RStudioServerPro
Domain-level app.
The ARN of the execution role for the RStudioServerPro
Domain-level\n app.
A collection of settings that configure the RStudioServerPro
Domain-level app.
A collection of settings that configure the RStudioServerPro
Domain-level\n app.
A collection of settings that update the current configuration for the RStudioServerPro
Domain-level app.
A collection of settings that update the current configuration for the\n RStudioServerPro
Domain-level app.
The Amazon Resource Name (ARN) of an Amazon Web Services Lambda function that provides credentials to\n authenticate to the private Docker registry where your model image is hosted. For\n information about how to create an Amazon Web Services Lambda function, see Create a Lambda function\n with the console in the Amazon Web Services Lambda Developer\n Guide.
", + "smithy.api#documentation": "The Amazon Resource Name (ARN) of an Amazon Web Services Lambda function that provides\n credentials to authenticate to the private Docker registry where your model image is\n hosted. For information about how to create an Amazon Web Services Lambda function, see\n Create a Lambda function\n with the console in the Amazon Web Services Lambda Developer\n Guide.
", "smithy.api#required": {} } } }, "traits": { - "smithy.api#documentation": "Specifies an authentication configuration for the private docker registry where your\n model image is hosted. Specify a value for this property only if you specified\n Vpc
as the value for the RepositoryAccessMode
field of the\n ImageConfig
object that you passed to a call to CreateModel
\n and the private Docker registry where the model image is\n hosted requires authentication.
Specifies an authentication configuration for the private docker registry where your\n model image is hosted. Specify a value for this property only if you specified\n Vpc
as the value for the RepositoryAccessMode
field of the\n ImageConfig
object that you passed to a call to\n CreateModel
and the private Docker registry where the model image is\n hosted requires authentication.
The Amazon Web Services KMS key that SageMaker uses to encrypt data on the storage volume attached to the ML\n compute instance(s) that run the training job.
\nCertain Nitro-based instances include local storage, dependent on the instance\n type. Local storage volumes are encrypted using a hardware module on the instance.\n You can't request a VolumeKmsKeyId
when using an instance type with\n local storage.
For a list of instance types that support local instance storage, see Instance Store Volumes.
\nFor more information about local instance storage encryption, see SSD\n Instance Store Volumes.
\nThe VolumeKmsKeyId
can be in any of the following formats:
// KMS Key ID
\n\n \"1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// Amazon Resource Name (ARN) of a KMS Key
\n\n \"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
The Amazon Web Services KMS key that SageMaker uses to encrypt data on the storage volume\n attached to the ML compute instance(s) that run the training job.
\nCertain Nitro-based instances include local storage, dependent on the instance\n type. Local storage volumes are encrypted using a hardware module on the instance.\n You can't request a VolumeKmsKeyId
when using an instance type with\n local storage.
For a list of instance types that support local instance storage, see Instance Store Volumes.
\nFor more information about local instance storage encryption, see SSD\n Instance Store Volumes.
\nThe VolumeKmsKeyId
can be in any of the following formats:
// KMS Key ID
\n\n \"1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
// Amazon Resource Name (ARN) of a KMS Key
\n\n \"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab\"
\n
A list of names of instance groups that get data \n from the S3 data source.
" + "smithy.api#documentation": "A list of names of instance groups that get data from the S3 data source.
" } } }, @@ -38367,13 +38468,13 @@ "AlgorithmName": { "target": "com.amazonaws.sagemaker#ArnOrName", "traits": { - "smithy.api#documentation": "The name of an algorithm that was used to create the model package. The algorithm must\n be either an algorithm resource in your SageMaker account or an algorithm in Amazon Web Services Marketplace that you\n are subscribed to.
", + "smithy.api#documentation": "The name of an algorithm that was used to create the model package. The algorithm must\n be either an algorithm resource in your SageMaker account or an algorithm in Amazon Web Services Marketplace that you are subscribed to.
", "smithy.api#required": {} } } }, "traits": { - "smithy.api#documentation": "Specifies an algorithm that was used to create the model package. The algorithm must\n be either an algorithm resource in your SageMaker account or an algorithm in Amazon Web Services Marketplace that you\n are subscribed to.
" + "smithy.api#documentation": "Specifies an algorithm that was used to create the model package. The algorithm must\n be either an algorithm resource in your SageMaker account or an algorithm in Amazon Web Services Marketplace that you are subscribed to.
" } }, "com.amazonaws.sagemaker#SourceAlgorithmList": { @@ -39140,7 +39241,7 @@ "MaxRuntimeInSeconds": { "target": "com.amazonaws.sagemaker#MaxRuntimeInSeconds", "traits": { - "smithy.api#documentation": "The maximum length of time, in seconds, that a training or compilation job can run.
\nFor compilation jobs, if the job does not complete during this time, a TimeOut
error\n is generated. We recommend starting with 900 seconds and increasing as \n necessary based on your model.
For all other jobs, if the job does not complete during this time, SageMaker ends the job. When \n RetryStrategy
is specified in the job request,\n MaxRuntimeInSeconds
specifies the maximum time for all of the attempts\n in total, not each individual attempt. The default value is 1 day. The maximum value is 28 days.
The maximum length of time, in seconds, that a training or compilation job can\n run.
\nFor compilation jobs, if the job does not complete during this time, a\n TimeOut
error is generated. We recommend starting with 900 seconds and\n increasing as necessary based on your model.
For all other jobs, if the job does not complete during this time, SageMaker ends the job.\n When RetryStrategy
is specified in the job request,\n MaxRuntimeInSeconds
specifies the maximum time for all of the attempts\n in total, not each individual attempt. The default value is 1 day. The maximum value is\n 28 days.
Specifies a limit to how long a model training job or model compilation job \n can run. It also specifies how long a managed spot training\n job has to complete. When the job reaches the time limit, SageMaker ends the training or\n compilation job. Use this API to cap model training costs.
\nTo stop a training job, SageMaker sends the algorithm the SIGTERM
signal, which delays\n job termination for 120 seconds. Algorithms can use this 120-second window to save the\n model artifacts, so the results of training are not lost.
The training algorithms provided by SageMaker automatically save the intermediate results\n of a model training job when possible. This attempt to save artifacts is only a best\n effort case as model might not be in a state from which it can be saved. For example, if\n training has just started, the model might not be ready to save. When saved, this\n intermediate data is a valid model artifact. You can use it to create a model with\n CreateModel
.
The Neural Topic Model (NTM) currently does not support saving intermediate model\n artifacts. When training NTMs, make sure that the maximum runtime is sufficient for\n the training job to complete.
\nSpecifies a limit to how long a model training job or model compilation job can run.\n It also specifies how long a managed spot training job has to complete. When the job\n reaches the time limit, SageMaker ends the training or compilation job. Use this API to cap\n model training costs.
\nTo stop a training job, SageMaker sends the algorithm the SIGTERM
signal,\n which delays job termination for 120 seconds. Algorithms can use this 120-second window\n to save the model artifacts, so the results of training are not lost.
The training algorithms provided by SageMaker automatically save the intermediate results\n of a model training job when possible. This attempt to save artifacts is only a best\n effort case as model might not be in a state from which it can be saved. For example, if\n training has just started, the model might not be ready to save. When saved, this\n intermediate data is a valid model artifact. You can use it to create a model with\n CreateModel
.
The Neural Topic Model (NTM) currently does not support saving intermediate model\n artifacts. When training NTMs, make sure that the maximum runtime is sufficient for\n the training job to complete.
\nA tag object that consists of a key and an optional value, used to manage metadata\n for SageMaker Amazon Web Services resources.
\nYou can add tags to notebook instances, training jobs, hyperparameter tuning jobs,\n batch transform jobs, models, labeling jobs, work teams, endpoint configurations, and\n endpoints. For more information on adding tags to SageMaker resources, see AddTags.
\nFor more information on adding metadata to your Amazon Web Services resources with tagging, see\n Tagging Amazon Web Services\n resources. For advice on best practices for managing Amazon Web Services resources with\n tagging, see Tagging\n Best Practices: Implement an Effective Amazon Web Services Resource Tagging Strategy.
" + "smithy.api#documentation": "A tag object that consists of a key and an optional value, used to manage metadata\n for SageMaker Amazon Web Services resources.
\nYou can add tags to notebook instances, training jobs, hyperparameter tuning jobs,\n batch transform jobs, models, labeling jobs, work teams, endpoint configurations, and\n endpoints. For more information on adding tags to SageMaker resources, see AddTags.
\nFor more information on adding metadata to your Amazon Web Services resources with\n tagging, see Tagging Amazon Web Services resources. For advice on best practices for\n managing Amazon Web Services resources with tagging, see Tagging\n Best Practices: Implement an Effective Amazon Web Services Resource Tagging\n Strategy.
" } }, "com.amazonaws.sagemaker#TagKey": { @@ -40074,7 +40175,7 @@ "com.amazonaws.sagemaker#TrainingInputMode": { "type": "string", "traits": { - "smithy.api#documentation": "The training input mode that the algorithm supports. For more information about input modes, see\n Algorithms.
\n\n\n Pipe mode\n
\nIf an algorithm supports Pipe
mode, Amazon SageMaker streams data directly\n from Amazon S3 to the container.
\n File mode\n
\nIf an algorithm supports File
mode, SageMaker\n downloads the training data from S3 to the provisioned ML storage volume, and mounts the\n directory to the Docker volume for the training container.
You must provision the ML storage volume with sufficient capacity\n to accommodate the data downloaded from S3. In addition to the training data, the ML\n storage volume also stores the output model. The algorithm container uses the ML storage\n volume to also store intermediate information, if any.
\nFor distributed algorithms, training data is distributed uniformly.\n Your training duration is predictable if the input data objects sizes are\n approximately the same. SageMaker does not split the files any further for model training.\n If the object sizes are skewed, training won't be optimal as the data distribution is also\n skewed when one host in a training cluster is overloaded, thus becoming a bottleneck in\n training.
\n\n\n FastFile mode\n
\nIf an algorithm supports FastFile
mode, SageMaker streams data directly\n from S3 to the container with no code changes, and provides file system access to\n the data. Users can author their training script to interact with these files as if\n they were stored on disk.
\n FastFile
mode works best when the data is read sequentially.\n Augmented manifest files aren't supported.\n The startup time is lower when there are fewer files in the S3 bucket provided.
The training input mode that the algorithm supports. For more information about input\n modes, see Algorithms.
\n\n\n Pipe mode\n
\nIf an algorithm supports Pipe
mode, Amazon SageMaker streams data directly from\n Amazon S3 to the container.
\n File mode\n
\nIf an algorithm supports File
mode, SageMaker downloads the training data from\n S3 to the provisioned ML storage volume, and mounts the directory to the Docker volume\n for the training container.
You must provision the ML storage volume with sufficient capacity to accommodate the\n data downloaded from S3. In addition to the training data, the ML storage volume also\n stores the output model. The algorithm container uses the ML storage volume to also\n store intermediate information, if any.
\nFor distributed algorithms, training data is distributed uniformly. Your training\n duration is predictable if the input data objects sizes are approximately the same. SageMaker\n does not split the files any further for model training. If the object sizes are skewed,\n training won't be optimal as the data distribution is also skewed when one host in a\n training cluster is overloaded, thus becoming a bottleneck in training.
\n\n\n FastFile mode\n
\nIf an algorithm supports FastFile
mode, SageMaker streams data directly from\n S3 to the container with no code changes, and provides file system access to the data.\n Users can author their training script to interact with these files as if they were\n stored on disk.
\n FastFile
mode works best when the data is read sequentially. Augmented\n manifest files aren't supported. The startup time is lower when there are fewer files in\n the S3 bucket provided.
The Amazon Web Services Identity and Access Management (IAM) role configured for the training job.
" + "smithy.api#documentation": "The Amazon Web Services Identity and Access Management (IAM) role configured for the\n training job.
" } }, "InputDataConfig": { @@ -40510,7 +40611,7 @@ "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services resources in\n different ways, for example, by purpose, owner, or environment. For more information,\n see Tagging Amazon Web Services\n Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your Amazon Web Services\n resources in different ways, for example, by purpose, owner, or environment. For more\n information, see Tagging Amazon Web Services Resources.
" } } }, @@ -42445,7 +42546,7 @@ "GitConfig": { "target": "com.amazonaws.sagemaker#GitConfigForUpdate", "traits": { - "smithy.api#documentation": "The configuration of the git repository, including the URL and the Amazon Resource\n Name (ARN) of the Amazon Web Services Secrets Manager secret that contains the credentials used to\n access the repository. The secret must have a staging label of AWSCURRENT
\n and must be in the following format:
\n {\"username\": UserName, \"password\":\n Password}
\n
The configuration of the git repository, including the URL and the Amazon Resource\n Name (ARN) of the Amazon Web Services Secrets Manager secret that contains the\n credentials used to access the repository. The secret must have a staging label of\n AWSCURRENT
and must be in the following format:
\n {\"username\": UserName, \"password\":\n Password}
\n
The deployment configuration for an endpoint, which contains the desired deployment strategy and rollback configurations.
" + "smithy.api#documentation": "The deployment configuration for an endpoint, which contains the desired deployment\n strategy and rollback configurations.
" } }, "RetainDeploymentConfig": { @@ -42871,7 +42972,7 @@ "FeatureAdditions": { "target": "com.amazonaws.sagemaker#FeatureAdditions", "traits": { - "smithy.api#documentation": "A list of the features that you're adding to the feature group.
" + "smithy.api#documentation": "Updates the feature group. Updating a feature group is an asynchronous operation. When\n you get an HTTP 200 response, you've made a valid request. It takes some time after you've\n made a valid request for Feature Store to update the feature group.
" } } } @@ -43186,13 +43287,13 @@ "DefaultCodeRepository": { "target": "com.amazonaws.sagemaker#CodeRepositoryNameOrUrl", "traits": { - "smithy.api#documentation": "The Git repository to associate with the notebook instance as its default code\n repository. This can be either the name of a Git repository stored as a resource in your\n account, or the URL of a Git repository in Amazon Web Services CodeCommit or in any\n other Git repository. When you open a notebook instance, it opens in the directory that\n contains this repository. For more information, see Associating Git Repositories with SageMaker\n Notebook Instances.
" + "smithy.api#documentation": "The Git repository to associate with the notebook instance as its default code\n repository. This can be either the name of a Git repository stored as a resource in your\n account, or the URL of a Git repository in Amazon Web Services CodeCommit\n or in any other Git repository. When you open a notebook instance, it opens in the\n directory that contains this repository. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" } }, "AdditionalCodeRepositories": { "target": "com.amazonaws.sagemaker#AdditionalCodeRepositoryNamesOrUrls", "traits": { - "smithy.api#documentation": "An array of up to three Git repositories to associate with the notebook instance.\n These can be either the names of Git repositories stored as resources in your account,\n or the URL of Git repositories in Amazon Web Services CodeCommit or in any\n other Git repository. These repositories are cloned at the same level as the default\n repository of your notebook instance. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" + "smithy.api#documentation": "An array of up to three Git repositories to associate with the notebook instance.\n These can be either the names of Git repositories stored as resources in your account,\n or the URL of Git repositories in Amazon Web Services CodeCommit\n or in any other Git repository. These repositories are cloned at the same level as the\n default repository of your notebook instance. For more information, see Associating Git\n Repositories with SageMaker Notebook Instances.
" } }, "AcceleratorTypes": { @@ -43453,7 +43554,7 @@ "Tags": { "target": "com.amazonaws.sagemaker#TagList", "traits": { - "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your \n Amazon Web Services resources in different ways, for example, by purpose, owner, or \n environment. For more information, see Tagging Amazon Web Services Resources.
" + "smithy.api#documentation": "An array of key-value pairs. You can use tags to categorize your \n Amazon Web Services resources in different ways, for example, by purpose, owner, or \n environment. For more information, see Tagging Amazon Web Services Resources.\n In addition, the project must have tag update constraints set in order to include this \n parameter in the request. For more information, see Amazon Web Services Service \n Catalog Tag Update Constraints.
" } } } @@ -44044,7 +44145,7 @@ "RStudioServerProAppSettings": { "target": "com.amazonaws.sagemaker#RStudioServerProAppSettings", "traits": { - "smithy.api#documentation": "A collection of settings that configure user interaction with the RStudioServerPro
app.
A collection of settings that configure user interaction with the\n RStudioServerPro
app.