From 1621e49a46f800e2a9bce5fb4dfed49049493afa Mon Sep 17 00:00:00 2001 From: arcadia-devtools Date: Wed, 18 May 2022 11:02:12 +0300 Subject: intermediate changes ref:068e4797397a145918d589e2cbd6254104d13441 --- contrib/python/boto3/py3/.dist-info/METADATA | 4 +- contrib/python/boto3/py3/boto3/__init__.py | 2 +- contrib/python/botocore/py3/.dist-info/METADATA | 2 +- contrib/python/botocore/py3/botocore/__init__.py | 2 +- .../botocore/data/ec2/2016-11-15/service-2.json | 11 +- .../botocore/py3/botocore/data/endpoints.json | 2 + .../2017-09-30/paginators-1.json | 6 + .../2017-09-30/service-2.json | 174 ++++++++++ .../data/kinesisvideo/2017-09-30/service-2.json | 350 ++++++++++++++++++++- .../py3/botocore/data/s3/2006-03-01/service-2.json | 10 +- .../data/sagemaker/2017-07-24/service-2.json | 28 ++ 11 files changed, 568 insertions(+), 23 deletions(-) (limited to 'contrib/python') diff --git a/contrib/python/boto3/py3/.dist-info/METADATA b/contrib/python/boto3/py3/.dist-info/METADATA index e2947c682b2..4f16833d860 100644 --- a/contrib/python/boto3/py3/.dist-info/METADATA +++ b/contrib/python/boto3/py3/.dist-info/METADATA @@ -1,6 +1,6 @@ Metadata-Version: 2.1 Name: boto3 -Version: 1.22.5 +Version: 1.22.6 Summary: The AWS SDK for Python Home-page: https://github.com/boto/boto3 Author: Amazon Web Services @@ -22,7 +22,7 @@ Classifier: Programming Language :: Python :: 3.10 Requires-Python: >= 3.6 License-File: LICENSE License-File: NOTICE -Requires-Dist: botocore (<1.26.0,>=1.25.5) +Requires-Dist: botocore (<1.26.0,>=1.25.6) Requires-Dist: jmespath (<2.0.0,>=0.7.1) Requires-Dist: s3transfer (<0.6.0,>=0.5.0) Provides-Extra: crt diff --git a/contrib/python/boto3/py3/boto3/__init__.py b/contrib/python/boto3/py3/boto3/__init__.py index 0cf09b7149d..7c9810c9860 100644 --- a/contrib/python/boto3/py3/boto3/__init__.py +++ b/contrib/python/boto3/py3/boto3/__init__.py @@ -17,7 +17,7 @@ from boto3.compat import _warn_deprecated_python from boto3.session import Session __author__ = 'Amazon Web Services' -__version__ = '1.22.5' +__version__ = '1.22.6' # The default Boto3 session; autoloaded when needed. diff --git a/contrib/python/botocore/py3/.dist-info/METADATA b/contrib/python/botocore/py3/.dist-info/METADATA index 23775c61947..dd25cffc35d 100644 --- a/contrib/python/botocore/py3/.dist-info/METADATA +++ b/contrib/python/botocore/py3/.dist-info/METADATA @@ -1,6 +1,6 @@ Metadata-Version: 2.1 Name: botocore -Version: 1.25.5 +Version: 1.25.6 Summary: Low-level, data-driven core of boto 3. Home-page: https://github.com/boto/botocore Author: Amazon Web Services diff --git a/contrib/python/botocore/py3/botocore/__init__.py b/contrib/python/botocore/py3/botocore/__init__.py index af6beb8168b..2d20b70cab3 100644 --- a/contrib/python/botocore/py3/botocore/__init__.py +++ b/contrib/python/botocore/py3/botocore/__init__.py @@ -16,7 +16,7 @@ import logging import os import re -__version__ = '1.25.5' +__version__ = '1.25.6' class NullHandler(logging.Handler): diff --git a/contrib/python/botocore/py3/botocore/data/ec2/2016-11-15/service-2.json b/contrib/python/botocore/py3/botocore/data/ec2/2016-11-15/service-2.json index c3d3f91a17b..712b77c7e72 100644 --- a/contrib/python/botocore/py3/botocore/data/ec2/2016-11-15/service-2.json +++ b/contrib/python/botocore/py3/botocore/data/ec2/2016-11-15/service-2.json @@ -5095,7 +5095,7 @@ }, "input":{"shape":"StopInstancesRequest"}, "output":{"shape":"StopInstancesResult"}, - "documentation":"

Stops an Amazon EBS-backed instance.

You can use the Stop action to hibernate an instance if the instance is enabled for hibernation and it meets the hibernation prerequisites. For more information, see Hibernate your instance in the Amazon EC2 User Guide.

We don't charge usage for a stopped instance, or data transfer fees; however, your root partition Amazon EBS volume remains and continues to persist your data, and you are charged for Amazon EBS volume usage. Every time you start your instance, Amazon EC2 charges a one-minute minimum for instance usage, and thereafter charges per second for instance usage.

You can't stop or hibernate instance store-backed instances. You can't use the Stop action to hibernate Spot Instances, but you can specify that Amazon EC2 should hibernate Spot Instances when they are interrupted. For more information, see Hibernating interrupted Spot Instances in the Amazon EC2 User Guide.

When you stop or hibernate an instance, we shut it down. You can restart your instance at any time. Before stopping or hibernating an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM, but hibernating an instance does preserve data stored in RAM. If an instance cannot hibernate successfully, a normal shutdown occurs.

Stopping and hibernating an instance is different to rebooting or terminating it. For example, when you stop or hibernate an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between rebooting, stopping, hibernating, and terminating instances, see Instance lifecycle in the Amazon EC2 User Guide.

When you stop an instance, we attempt to shut it down forcibly after a short while. If your instance appears stuck in the stopping state after a period of time, there may be an issue with the underlying host computer. For more information, see Troubleshoot stopping your instance in the Amazon EC2 User Guide.

" + "documentation":"

Stops an Amazon EBS-backed instance. For more information, see Stop and start your instance in the Amazon EC2 User Guide.

You can use the Stop action to hibernate an instance if the instance is enabled for hibernation and it meets the hibernation prerequisites. For more information, see Hibernate your instance in the Amazon EC2 User Guide.

We don't charge usage for a stopped instance, or data transfer fees; however, your root partition Amazon EBS volume remains and continues to persist your data, and you are charged for Amazon EBS volume usage. Every time you start your instance, Amazon EC2 charges a one-minute minimum for instance usage, and thereafter charges per second for instance usage.

You can't stop or hibernate instance store-backed instances. You can't use the Stop action to hibernate Spot Instances, but you can specify that Amazon EC2 should hibernate Spot Instances when they are interrupted. For more information, see Hibernating interrupted Spot Instances in the Amazon EC2 User Guide.

When you stop or hibernate an instance, we shut it down. You can restart your instance at any time. Before stopping or hibernating an instance, make sure it is in a state from which it can be restarted. Stopping an instance does not preserve data stored in RAM, but hibernating an instance does preserve data stored in RAM. If an instance cannot hibernate successfully, a normal shutdown occurs.

Stopping and hibernating an instance is different to rebooting or terminating it. For example, when you stop or hibernate an instance, the root device and any other devices attached to the instance persist. When you terminate an instance, the root device and any other devices attached during the instance launch are automatically deleted. For more information about the differences between rebooting, stopping, hibernating, and terminating instances, see Instance lifecycle in the Amazon EC2 User Guide.

When you stop an instance, we attempt to shut it down forcibly after a short while. If your instance appears stuck in the stopping state after a period of time, there may be an issue with the underlying host computer. For more information, see Troubleshoot stopping your instance in the Amazon EC2 User Guide.

" }, "TerminateClientVpnConnections":{ "name":"TerminateClientVpnConnections", @@ -5986,6 +5986,10 @@ "HostRecovery":{ "shape":"HostRecovery", "documentation":"

Indicates whether to enable or disable host recovery for the Dedicated Host. Host recovery is disabled by default. For more information, see Host recovery in the Amazon EC2 User Guide.

Default: off

" + }, + "OutpostArn":{ + "shape":"String", + "documentation":"

The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which to allocate the Dedicated Host.

" } } }, @@ -27127,6 +27131,11 @@ "shape":"Boolean", "documentation":"

Indicates whether the Dedicated Host is in a host resource group. If memberOfServiceLinkedResourceGroup is true, the host is in a host resource group; otherwise, it is not.

", "locationName":"memberOfServiceLinkedResourceGroup" + }, + "OutpostArn":{ + "shape":"String", + "documentation":"

The Amazon Resource Name (ARN) of the Amazon Web Services Outpost on which the Dedicated Host is allocated.

", + "locationName":"outpostArn" } }, "documentation":"

Describes the properties of the Dedicated Host.

" diff --git a/contrib/python/botocore/py3/botocore/data/endpoints.json b/contrib/python/botocore/py3/botocore/data/endpoints.json index 5260c984880..15795230b2e 100644 --- a/contrib/python/botocore/py3/botocore/data/endpoints.json +++ b/contrib/python/botocore/py3/botocore/data/endpoints.json @@ -4041,6 +4041,7 @@ "ap-south-1" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, + "ap-southeast-3" : { }, "ca-central-1" : { }, "eu-central-1" : { }, "eu-north-1" : { }, @@ -7404,6 +7405,7 @@ "ap-south-1" : { }, "ap-southeast-1" : { }, "ap-southeast-2" : { }, + "ap-southeast-3" : { }, "ca-central-1" : { }, "eu-central-1" : { }, "eu-north-1" : { }, diff --git a/contrib/python/botocore/py3/botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json b/contrib/python/botocore/py3/botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json index f5e4d7322bf..a9a70417be4 100644 --- a/contrib/python/botocore/py3/botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json +++ b/contrib/python/botocore/py3/botocore/data/kinesis-video-archived-media/2017-09-30/paginators-1.json @@ -5,6 +5,12 @@ "limit_key": "MaxResults", "output_token": "NextToken", "result_key": "Fragments" + }, + "GetImages": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "Images" } } } diff --git a/contrib/python/botocore/py3/botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json b/contrib/python/botocore/py3/botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json index 791ed11965d..a074f379800 100644 --- a/contrib/python/botocore/py3/botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json +++ b/contrib/python/botocore/py3/botocore/data/kinesis-video-archived-media/2017-09-30/service-2.json @@ -72,6 +72,22 @@ ], "documentation":"

Retrieves an HTTP Live Streaming (HLS) URL for the stream. You can then open the URL in a browser or media player to view the stream contents.

Both the StreamName and the StreamARN parameters are optional, but you must specify either the StreamName or the StreamARN when invoking this API operation.

An Amazon Kinesis video stream has the following requirements for providing data through HLS:

Kinesis Video Streams HLS sessions contain fragments in the fragmented MPEG-4 form (also called fMP4 or CMAF) or the MPEG-2 form (also called TS chunks, which the HLS specification also supports). For more information about HLS fragment types, see the HLS specification.

The following procedure shows how to use HLS with Kinesis Video Streams:

  1. Get an endpoint using GetDataEndpoint, specifying GET_HLS_STREAMING_SESSION_URL for the APIName parameter.

  2. Retrieve the HLS URL using GetHLSStreamingSessionURL. Kinesis Video Streams creates an HLS streaming session to be used for accessing content in a stream using the HLS protocol. GetHLSStreamingSessionURL returns an authenticated URL (that includes an encrypted session token) for the session's HLS master playlist (the root resource needed for streaming with HLS).

    Don't share or store this token where an unauthorized entity could access it. The token provides access to the content of the stream. Safeguard the token with the same measures that you would use with your AWS credentials.

    The media that is made available through the playlist consists only of the requested stream, time range, and format. No other media data (such as frames outside the requested window or alternate bitrates) is made available.

  3. Provide the URL (containing the encrypted session token) for the HLS master playlist to a media player that supports the HLS protocol. Kinesis Video Streams makes the HLS media playlist, initialization fragment, and media fragments available through the master playlist URL. The initialization fragment contains the codec private data for the stream, and other data needed to set up the video or audio decoder and renderer. The media fragments contain H.264-encoded video frames or AAC-encoded audio samples.

  4. The media player receives the authenticated URL and requests stream metadata and media data normally. When the media player requests data, it calls the following actions:

    • GetHLSMasterPlaylist: Retrieves an HLS master playlist, which contains a URL for the GetHLSMediaPlaylist action for each track, and additional metadata for the media player, including estimated bitrate and resolution.

    • GetHLSMediaPlaylist: Retrieves an HLS media playlist, which contains a URL to access the MP4 initialization fragment with the GetMP4InitFragment action, and URLs to access the MP4 media fragments with the GetMP4MediaFragment actions. The HLS media playlist also contains metadata about the stream that the player needs to play it, such as whether the PlaybackMode is LIVE or ON_DEMAND. The HLS media playlist is typically static for sessions with a PlaybackType of ON_DEMAND. The HLS media playlist is continually updated with new fragments for sessions with a PlaybackType of LIVE. There is a distinct HLS media playlist for the video track and the audio track (if applicable) that contains MP4 media URLs for the specific track.

    • GetMP4InitFragment: Retrieves the MP4 initialization fragment. The media player typically loads the initialization fragment before loading any media fragments. This fragment contains the \"fytp\" and \"moov\" MP4 atoms, and the child atoms that are needed to initialize the media player decoder.

      The initialization fragment does not correspond to a fragment in a Kinesis video stream. It contains only the codec private data for the stream and respective track, which the media player needs to decode the media frames.

    • GetMP4MediaFragment: Retrieves MP4 media fragments. These fragments contain the \"moof\" and \"mdat\" MP4 atoms and their child atoms, containing the encoded fragment's media frames and their timestamps.

      After the first media fragment is made available in a streaming session, any fragments that don't contain the same codec private data cause an error to be returned when those different media fragments are loaded. Therefore, the codec private data should not change between fragments in a session. This also means that the session fails if the fragments in a stream change from having only video to having both audio and video.

      Data retrieved with this action is billable. See Pricing for details.

    • GetTSFragment: Retrieves MPEG TS fragments containing both initialization and media data for all tracks in the stream.

      If the ContainerFormat is MPEG_TS, this API is used instead of GetMP4InitFragment and GetMP4MediaFragment to retrieve stream media.

      Data retrieved with this action is billable. For more information, see Kinesis Video Streams pricing.

A streaming session URL must not be shared between players. The service might throttle a session if multiple media players are sharing it. For connection limits, see Kinesis Video Streams Limits.

You can monitor the amount of data that the media player consumes by monitoring the GetMP4MediaFragment.OutgoingBytes Amazon CloudWatch metric. For information about using CloudWatch to monitor Kinesis Video Streams, see Monitoring Kinesis Video Streams. For pricing information, see Amazon Kinesis Video Streams Pricing and AWS Pricing. Charges for both HLS sessions and outgoing AWS data apply.

For more information about HLS, see HTTP Live Streaming on the Apple Developer site.

If an error is thrown after invoking a Kinesis Video Streams archived media API, in addition to the HTTP status code and the response body, it includes the following pieces of information:

Both the HTTP status code and the ErrorType header can be utilized to make programmatic decisions about whether errors are retry-able and under what conditions, as well as provide information on what actions the client programmer might need to take in order to successfully try again.

For more information, see the Errors section at the bottom of this topic, as well as Common Errors.

" }, + "GetImages":{ + "name":"GetImages", + "http":{ + "method":"POST", + "requestUri":"/getImages" + }, + "input":{"shape":"GetImagesInput"}, + "output":{"shape":"GetImagesOutput"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidArgumentException"}, + {"shape":"ClientLimitExceededException"}, + {"shape":"NotAuthorizedException"} + ], + "documentation":"

Retrieves a list of Images corresponding to each timestamp for a given time range, sampling interval, and image format configuration.

" + }, "GetMediaForFragmentList":{ "name":"GetMediaForFragmentList", "http":{ @@ -240,6 +256,30 @@ "max":43200, "min":300 }, + "Format":{ + "type":"string", + "enum":[ + "JPEG", + "PNG" + ] + }, + "FormatConfig":{ + "type":"map", + "key":{"shape":"FormatConfigKey"}, + "value":{"shape":"FormatConfigValue"}, + "max":1, + "min":1 + }, + "FormatConfigKey":{ + "type":"string", + "enum":["JPEGQuality"] + }, + "FormatConfigValue":{ + "type":"string", + "max":256, + "min":0, + "pattern":"^[a-zA-Z_0-9]+" + }, "Fragment":{ "type":"structure", "members":{ @@ -437,6 +477,84 @@ } } }, + "GetImagesInput":{ + "type":"structure", + "required":[ + "ImageSelectorType", + "StartTimestamp", + "EndTimestamp", + "SamplingInterval", + "Format" + ], + "members":{ + "StreamName":{ + "shape":"StreamName", + "documentation":"

The name of the stream from which to retrieve the images. You must specify either the StreamName or the StreamARN.

" + }, + "StreamARN":{ + "shape":"ResourceARN", + "documentation":"

The Amazon Resource Name (ARN) of the stream from which to retrieve the images. You must specify either the StreamName or the StreamARN.

" + }, + "ImageSelectorType":{ + "shape":"ImageSelectorType", + "documentation":"

The origin of the Server or Producer timestamps to use to generate the images.

" + }, + "StartTimestamp":{ + "shape":"Timestamp", + "documentation":"

The starting point from which the images should be generated. This StartTimestamp must be within an inclusive range of timestamps for an image to be returned.

" + }, + "EndTimestamp":{ + "shape":"Timestamp", + "documentation":"

The end timestamp for the range of images to be generated.

" + }, + "SamplingInterval":{ + "shape":"SamplingInterval", + "documentation":"

The time interval in milliseconds (ms) at which the images need to be generated from the stream. The minimum value that can be provided is 3000 ms. If the timestamp range is less than the sampling interval, the Image from the startTimestamp will be returned if available.

The minimum value of 3000 ms is a soft limit. If needed, a lower sampling frequency can be requested.

" + }, + "Format":{ + "shape":"Format", + "documentation":"

The format that will be used to encode the image.

" + }, + "FormatConfig":{ + "shape":"FormatConfig", + "documentation":"

The list of a key-value pair structure that contains extra parameters that can be applied when the image is generated. The FormatConfig key is the JPEGQuality, which indicates the JPEG quality key to be used to generate the image. The FormatConfig value accepts ints from 1 to 100. If the value is 1, the image will be generated with less quality and the best compression. If the value is 100, the image will be generated with the best quality and less compression. If no value is provided, the default value of the JPEGQuality key will be set to 80.

" + }, + "WidthPixels":{ + "shape":"WidthPixels", + "documentation":"

The width of the output image that is used in conjunction with the HeightPixels parameter. When both WidthPixels and HeightPixels parameters are provided, the image will be stretched to fit the specified aspect ratio. If only the WidthPixels parameter is provided or if only the HeightPixels is provided, a ValidationException will be thrown. If neither parameter is provided, the original image size from the stream will be returned.

" + }, + "HeightPixels":{ + "shape":"HeightPixels", + "documentation":"

The height of the output image that is used in conjunction with the WidthPixels parameter. When both HeightPixels and WidthPixels parameters are provided, the image will be stretched to fit the specified aspect ratio. If only the HeightPixels parameter is provided, its original aspect ratio will be used to calculate the WidthPixels ratio. If neither parameter is provided, the original image size will be returned.

" + }, + "MaxResults":{ + "shape":"GetImagesMaxResults", + "documentation":"

The maximum number of images to be returned by the API.

The default limit is 100 images per API response. The additional results will be paginated.

" + }, + "NextToken":{ + "shape":"NextToken", + "documentation":"

A token that specifies where to start paginating the next set of Images. This is the GetImages:NextToken from a previously truncated response.

" + } + } + }, + "GetImagesMaxResults":{ + "type":"long", + "max":100, + "min":1 + }, + "GetImagesOutput":{ + "type":"structure", + "members":{ + "Images":{ + "shape":"Images", + "documentation":"

The list of images generated from the video stream. If there is no media available for the given timestamp, the NO_MEDIA error will be listed in the output. If an error occurs while the image is being generated, the MEDIA_ERROR will be listed in the output as the cause of the missing image.

" + }, + "NextToken":{ + "shape":"NextToken", + "documentation":"

The encrypted token that was used in the request to get more images.

" + } + } + }, "GetMediaForFragmentListInput":{ "type":"structure", "required":["Fragments"], @@ -535,6 +653,52 @@ }, "documentation":"

The start and end of the timestamp range for the requested media.

This value should not be present if PlaybackType is LIVE.

" }, + "HeightPixels":{ + "type":"integer", + "max":2160, + "min":1 + }, + "Image":{ + "type":"structure", + "members":{ + "TimeStamp":{ + "shape":"Timestamp", + "documentation":"

An attribute of the Image object that is used to extract an image from the video stream. This field is used to manage gaps on images or to better understand the pagination window.

" + }, + "Error":{ + "shape":"ImageError", + "documentation":"

The error message shown when the image for the provided timestamp was not extracted due to a non-tryable error. An error will be returned if:

" + }, + "ImageContent":{ + "shape":"ImageContent", + "documentation":"

An attribute of the Image object that is Base64 encoded.

" + } + }, + "documentation":"

A structure that contains the Timestamp, Error, and ImageContent.

" + }, + "ImageContent":{ + "type":"string", + "max":6291456, + "min":1 + }, + "ImageError":{ + "type":"string", + "enum":[ + "NO_MEDIA", + "MEDIA_ERROR" + ] + }, + "ImageSelectorType":{ + "type":"string", + "enum":[ + "PRODUCER_TIMESTAMP", + "SERVER_TIMESTAMP" + ] + }, + "Images":{ + "type":"list", + "member":{"shape":"Image"} + }, "InvalidArgumentException":{ "type":"structure", "members":{ @@ -658,6 +822,11 @@ "error":{"httpStatusCode":404}, "exception":true }, + "SamplingInterval":{ + "type":"integer", + "max":20000, + "min":3000 + }, "StreamName":{ "type":"string", "max":256, @@ -691,6 +860,11 @@ "documentation":"

The type of the media (for example, h.264 or h.265 video or ACC or G.711 audio) could not be determined from the codec IDs of the tracks in the first fragment for a playback session. The codec ID for track 1 should be V_MPEG/ISO/AVC and, optionally, the codec ID for track 2 should be A_AAC.

", "error":{"httpStatusCode":400}, "exception":true + }, + "WidthPixels":{ + "type":"integer", + "max":3840, + "min":1 } }, "documentation":"

" diff --git a/contrib/python/botocore/py3/botocore/data/kinesisvideo/2017-09-30/service-2.json b/contrib/python/botocore/py3/botocore/data/kinesisvideo/2017-09-30/service-2.json index 47e458f03d0..541f2289689 100644 --- a/contrib/python/botocore/py3/botocore/data/kinesisvideo/2017-09-30/service-2.json +++ b/contrib/python/botocore/py3/botocore/data/kinesisvideo/2017-09-30/service-2.json @@ -84,6 +84,38 @@ ], "documentation":"

Deletes a Kinesis video stream and the data contained in the stream.

This method marks the stream for deletion, and makes the data in the stream inaccessible immediately.

To ensure that you have the latest version of the stream before deleting it, you can specify the stream version. Kinesis Video Streams assigns a version to each stream. When you update a stream, Kinesis Video Streams assigns a new version number. To get the latest stream version, use the DescribeStream API.

This operation requires permission for the KinesisVideo:DeleteStream action.

" }, + "DescribeImageGenerationConfiguration":{ + "name":"DescribeImageGenerationConfiguration", + "http":{ + "method":"POST", + "requestUri":"/describeImageGenerationConfiguration" + }, + "input":{"shape":"DescribeImageGenerationConfigurationInput"}, + "output":{"shape":"DescribeImageGenerationConfigurationOutput"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"ClientLimitExceededException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"} + ], + "documentation":"

Gets the ImageGenerationConfiguration for a given Kinesis video stream.

" + }, + "DescribeNotificationConfiguration":{ + "name":"DescribeNotificationConfiguration", + "http":{ + "method":"POST", + "requestUri":"/describeNotificationConfiguration" + }, + "input":{"shape":"DescribeNotificationConfigurationInput"}, + "output":{"shape":"DescribeNotificationConfigurationOutput"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"ClientLimitExceededException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"} + ], + "documentation":"

Gets the NotificationConfiguration for a given Kinesis video stream.

" + }, "DescribeSignalingChannel":{ "name":"DescribeSignalingChannel", "http":{ @@ -226,7 +258,7 @@ {"shape":"AccessDeniedException"}, {"shape":"TagsPerResourceExceededLimitException"} ], - "documentation":"

Adds one or more tags to a signaling channel. A tag is a key-value pair (the value is optional) that you can define and assign to AWS resources. If you specify a tag that already exists, the tag value is replaced with the value that you specify in the request. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

" + "documentation":"

Adds one or more tags to a signaling channel. A tag is a key-value pair (the value is optional) that you can define and assign to Amazon Web Services resources. If you specify a tag that already exists, the tag value is replaced with the value that you specify in the request. For more information, see Using Cost Allocation Tags in the Billing and Cost Management and Cost Management User Guide.

" }, "TagStream":{ "name":"TagStream", @@ -244,7 +276,7 @@ {"shape":"InvalidResourceFormatException"}, {"shape":"TagsPerResourceExceededLimitException"} ], - "documentation":"

Adds one or more tags to a stream. A tag is a key-value pair (the value is optional) that you can define and assign to AWS resources. If you specify a tag that already exists, the tag value is replaced with the value that you specify in the request. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

You must provide either the StreamName or the StreamARN.

This operation requires permission for the KinesisVideo:TagStream action.

Kinesis video streams support up to 50 tags.

" + "documentation":"

Adds one or more tags to a stream. A tag is a key-value pair (the value is optional) that you can define and assign to Amazon Web Services resources. If you specify a tag that already exists, the tag value is replaced with the value that you specify in the request. For more information, see Using Cost Allocation Tags in the Billing and Cost Management and Cost Management User Guide.

You must provide either the StreamName or the StreamARN.

This operation requires permission for the KinesisVideo:TagStream action.

A Kinesis video stream can support up to 50 tags.

" }, "UntagResource":{ "name":"UntagResource", @@ -297,6 +329,42 @@ ], "documentation":"

Increases or decreases the stream's data retention period by the value that you specify. To indicate whether you want to increase or decrease the data retention period, specify the Operation parameter in the request body. In the request, you must specify either the StreamName or the StreamARN.

The retention period that you specify replaces the current value.

This operation requires permission for the KinesisVideo:UpdateDataRetention action.

Changing the data retention period affects the data in the stream as follows:

" }, + "UpdateImageGenerationConfiguration":{ + "name":"UpdateImageGenerationConfiguration", + "http":{ + "method":"POST", + "requestUri":"/updateImageGenerationConfiguration" + }, + "input":{"shape":"UpdateImageGenerationConfigurationInput"}, + "output":{"shape":"UpdateImageGenerationConfigurationOutput"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"ClientLimitExceededException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ResourceInUseException"}, + {"shape":"NoDataRetentionException"} + ], + "documentation":"

Updates the StreamInfo and ImageProcessingConfiguration fields.

" + }, + "UpdateNotificationConfiguration":{ + "name":"UpdateNotificationConfiguration", + "http":{ + "method":"POST", + "requestUri":"/updateNotificationConfiguration" + }, + "input":{"shape":"UpdateNotificationConfigurationInput"}, + "output":{"shape":"UpdateNotificationConfigurationOutput"}, + "errors":[ + {"shape":"InvalidArgumentException"}, + {"shape":"ClientLimitExceededException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ResourceInUseException"}, + {"shape":"NoDataRetentionException"} + ], + "documentation":"

Updates the notification information for a stream.

" + }, "UpdateSignalingChannel":{ "name":"UpdateSignalingChannel", "http":{ @@ -344,7 +412,8 @@ "GET_MEDIA_FOR_FRAGMENT_LIST", "GET_HLS_STREAMING_SESSION_URL", "GET_DASH_STREAMING_SESSION_URL", - "GET_CLIP" + "GET_CLIP", + "GET_IMAGES" ] }, "AccessDeniedException":{ @@ -361,7 +430,7 @@ "members":{ "Message":{"shape":"ErrorMessage"} }, - "documentation":"

You have reached the maximum limit of active signaling channels for this AWS account in this region.

", + "documentation":"

You have reached the maximum limit of active signaling channels for this Amazon Web Services account in this region.

", "error":{"httpStatusCode":400}, "exception":true }, @@ -448,7 +517,10 @@ }, "ChannelType":{ "type":"string", - "enum":["SINGLE_MASTER"] + "enum":[ + "SINGLE_MASTER", + "FULL_MESH" + ] }, "ClientLimitExceededException":{ "type":"structure", @@ -463,13 +535,20 @@ "type":"string", "enum":["BEGINS_WITH"] }, + "ConfigurationStatus":{ + "type":"string", + "enum":[ + "ENABLED", + "DISABLED" + ] + }, "CreateSignalingChannelInput":{ "type":"structure", "required":["ChannelName"], "members":{ "ChannelName":{ "shape":"ChannelName", - "documentation":"

A name for the signaling channel that you are creating. It must be unique for each AWS account and AWS Region.

" + "documentation":"

A name for the signaling channel that you are creating. It must be unique for each Amazon Web Services account and Amazon Web Services Region.

" }, "ChannelType":{ "shape":"ChannelType", @@ -512,7 +591,7 @@ }, "KmsKeyId":{ "shape":"KmsKeyId", - "documentation":"

The ID of the AWS Key Management Service (AWS KMS) key that you want Kinesis Video Streams to use to encrypt stream data.

If no key ID is specified, the default, Kinesis Video-managed key (aws/kinesisvideo) is used.

For more information, see DescribeKey.

" + "documentation":"

The ID of the Key Management Service (KMS) key that you want Kinesis Video Streams to use to encrypt stream data.

If no key ID is specified, the default, Kinesis Video-managed key (aws/kinesisvideo) is used.

For more information, see DescribeKey.

" }, "DataRetentionInHours":{ "shape":"DataRetentionInHours", @@ -580,6 +659,50 @@ "members":{ } }, + "DescribeImageGenerationConfigurationInput":{ + "type":"structure", + "members":{ + "StreamName":{ + "shape":"StreamName", + "documentation":"

The name of the stream from which to retrieve the image generation configuration. You must specify either the StreamName or the StreamARN.

" + }, + "StreamARN":{ + "shape":"ResourceARN", + "documentation":"

The Amazon Resource Name (ARN) of the Kinesis video stream from which to retrieve the image generation configuration. You must specify either the StreamName or the StreamARN.

" + } + } + }, + "DescribeImageGenerationConfigurationOutput":{ + "type":"structure", + "members":{ + "ImageGenerationConfiguration":{ + "shape":"ImageGenerationConfiguration", + "documentation":"

The structure that contains the information required for the Kinesis video stream (KVS) images delivery. If this structure is null, the configuration will be deleted from the stream.

" + } + } + }, + "DescribeNotificationConfigurationInput":{ + "type":"structure", + "members":{ + "StreamName":{ + "shape":"StreamName", + "documentation":"

The name of the stream from which to retrieve the notification configuration. You must specify either the StreamName or the StreamARN.

" + }, + "StreamARN":{ + "shape":"ResourceARN", + "documentation":"

The Amazon Resource Name (ARN) of the Kinesis video stream from where you want to retrieve the notification configuration. You must specify either the StreamName or the StreamARN.

" + } + } + }, + "DescribeNotificationConfigurationOutput":{ + "type":"structure", + "members":{ + "NotificationConfiguration":{ + "shape":"NotificationConfiguration", + "documentation":"

The structure that contains the information required for notifications. If the structure is null, the configuration will be deleted from the stream.

" + } + } + }, "DescribeSignalingChannelInput":{ "type":"structure", "members":{ @@ -624,6 +747,18 @@ } } }, + "DestinationRegion":{ + "type":"string", + "max":14, + "min":9, + "pattern":"^[a-z]+(-[a-z]+)?-[a-z]+-[0-9]$" + }, + "DestinationUri":{ + "type":"string", + "max":255, + "min":1, + "pattern":"^[a-zA-Z_0-9]+:(//)?([^/]+)/?([^*]*)$" + }, "DeviceName":{ "type":"string", "max":128, @@ -640,6 +775,30 @@ "exception":true }, "ErrorMessage":{"type":"string"}, + "Format":{ + "type":"string", + "enum":[ + "JPEG", + "PNG" + ] + }, + "FormatConfig":{ + "type":"map", + "key":{"shape":"FormatConfigKey"}, + "value":{"shape":"FormatConfigValue"}, + "max":1, + "min":1 + }, + "FormatConfigKey":{ + "type":"string", + "enum":["JPEGQuality"] + }, + "FormatConfigValue":{ + "type":"string", + "max":256, + "min":0, + "pattern":"^[a-zA-Z_0-9]+" + }, "GetDataEndpointInput":{ "type":"structure", "required":["APIName"], @@ -690,6 +849,81 @@ } } }, + "HeightPixels":{ + "type":"integer", + "max":2160, + "min":1 + }, + "ImageGenerationConfiguration":{ + "type":"structure", + "required":[ + "Status", + "ImageSelectorType", + "DestinationConfig", + "SamplingInterval", + "Format" + ], + "members":{ + "Status":{ + "shape":"ConfigurationStatus", + "documentation":"

Indicates whether the ContinuousImageGenerationConfigurations API is enabled or disabled.

" + }, + "ImageSelectorType":{ + "shape":"ImageSelectorType", + "documentation":"

The origin of the Server or Producer timestamps to use to generate the images.

" + }, + "DestinationConfig":{ + "shape":"ImageGenerationDestinationConfig", + "documentation":"

The structure that contains the information required to deliver images to a customer.

" + }, + "SamplingInterval":{ + "shape":"SamplingInterval", + "documentation":"

The time interval in milliseconds (ms) at which the images need to be generated from the stream. The minimum value that can be provided is 33 ms, because a camera that generates content at 30 FPS would create a frame every 33.3 ms. If the timestamp range is less than the sampling interval, the Image from the StartTimestamp will be returned if available.

" + }, + "Format":{ + "shape":"Format", + "documentation":"

The accepted image format.

" + }, + "FormatConfig":{ + "shape":"FormatConfig", + "documentation":"

The list of a key-value pair structure that contains extra parameters that can be applied when the image is generated. The FormatConfig key is the JPEGQuality, which indicates the JPEG quality key to be used to generate the image. The FormatConfig value accepts ints from 1 to 100. If the value is 1, the image will be generated with less quality and the best compression. If the value is 100, the image will be generated with the best quality and less compression. If no value is provided, the default value of the JPEGQuality key will be set to 80.

" + }, + "WidthPixels":{ + "shape":"WidthPixels", + "documentation":"

The width of the output image that is used in conjunction with the HeightPixels parameter. When both WidthPixels and HeightPixels parameters are provided, the image will be stretched to fit the specified aspect ratio. If only the WidthPixels parameter is provided, its original aspect ratio will be used to calculate the HeightPixels ratio. If neither parameter is provided, the original image size will be returned.

" + }, + "HeightPixels":{ + "shape":"HeightPixels", + "documentation":"

The height of the output image that is used in conjunction with the WidthPixels parameter. When both HeightPixels and WidthPixels parameters are provided, the image will be stretched to fit the specified aspect ratio. If only the HeightPixels parameter is provided, its original aspect ratio will be used to calculate the WidthPixels ratio. If neither parameter is provided, the original image size will be returned.

" + } + }, + "documentation":"

The structure that contains the information required for the KVS images delivery. If null, the configuration will be deleted from the stream.

" + }, + "ImageGenerationDestinationConfig":{ + "type":"structure", + "required":[ + "Uri", + "DestinationRegion" + ], + "members":{ + "Uri":{ + "shape":"DestinationUri", + "documentation":"

The Uniform Resource Idenifier (URI) that identifies where the images will be delivered.

" + }, + "DestinationRegion":{ + "shape":"DestinationRegion", + "documentation":"

The AWS Region of the S3 bucket where images will be delivered. This DestinationRegion must match the Region where the stream is located.

" + } + }, + "documentation":"

The structure that contains the information required to deliver images to a customer.

" + }, + "ImageSelectorType":{ + "type":"string", + "enum":[ + "SERVER_TIMESTAMP", + "PRODUCER_TIMESTAMP" + ] + }, "InvalidArgumentException":{ "type":"structure", "members":{ @@ -868,6 +1102,15 @@ "min":0, "pattern":"[a-zA-Z0-9+/=]*" }, + "NoDataRetentionException":{ + "type":"structure", + "members":{ + "Message":{"shape":"ErrorMessage"} + }, + "documentation":"

The Stream data retention in hours is equal to zero.

", + "error":{"httpStatusCode":400}, + "exception":true + }, "NotAuthorizedException":{ "type":"structure", "members":{ @@ -877,11 +1120,40 @@ "error":{"httpStatusCode":401}, "exception":true }, + "NotificationConfiguration":{ + "type":"structure", + "required":[ + "Status", + "DestinationConfig" + ], + "members":{ + "Status":{ + "shape":"ConfigurationStatus", + "documentation":"

Indicates if a notification configuration is enabled or disabled.

" + }, + "DestinationConfig":{ + "shape":"NotificationDestinationConfig", + "documentation":"

The destination information required to deliver a notification to a customer.

" + } + }, + "documentation":"

The structure that contains the notification information for the KVS images delivery. If this parameter is null, the configuration will be deleted from the stream.

" + }, + "NotificationDestinationConfig":{ + "type":"structure", + "required":["Uri"], + "members":{ + "Uri":{ + "shape":"DestinationUri", + "documentation":"

The Uniform Resource Idenifier (URI) that identifies where the images will be delivered.

" + } + }, + "documentation":"

The structure that contains the information required to deliver a notification to a customer.

" + }, "ResourceARN":{ "type":"string", "max":1024, "min":1, - "pattern":"arn:aws:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+" + "pattern":"arn:[a-z\\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+" }, "ResourceEndpoint":{"type":"string"}, "ResourceEndpointList":{ @@ -907,7 +1179,7 @@ "members":{ "Message":{"shape":"ErrorMessage"} }, - "documentation":"

The signaling channel is currently not available for this operation.

", + "documentation":"

The resource is currently not available for this operation. New resources cannot be created with the same name as existing resources. Also, resources cannot be updated or deleted unless they are in an ACTIVE state.

If this exception is returned, do not use it to determine whether the requested resource already exists. Instead, it is recommended you use the resource-specific describe API, for example, DescribeStream for video streams.

", "error":{"httpStatusCode":400}, "exception":true }, @@ -927,6 +1199,11 @@ "max":50, "min":1 }, + "SamplingInterval":{ + "type":"integer", + "max":20000, + "min":3000 + }, "SingleMasterChannelEndpointConfiguration":{ "type":"structure", "members":{ @@ -946,7 +1223,7 @@ "members":{ "MessageTtlSeconds":{ "shape":"MessageTtlSeconds", - "documentation":"

The period of time a signaling channel retains underlivered messages before they are discarded.

" + "documentation":"

The period of time a signaling channel retains undelivered messages before they are discarded.

" } }, "documentation":"

A structure that contains the configuration for the SINGLE_MASTER channel type.

" @@ -981,7 +1258,7 @@ }, "KmsKeyId":{ "shape":"KmsKeyId", - "documentation":"

The ID of the AWS Key Management Service (AWS KMS) key that Kinesis Video Streams uses to encrypt data on the stream.

" + "documentation":"

The ID of the Key Management Service (KMS) key that Kinesis Video Streams uses to encrypt data on the stream.

" }, "Version":{ "shape":"Version", @@ -1124,7 +1401,7 @@ "members":{ "Message":{"shape":"ErrorMessage"} }, - "documentation":"

You have exceeded the limit of tags that you can associate with the resource. Kinesis video streams support up to 50 tags.

", + "documentation":"

You have exceeded the limit of tags that you can associate with the resource. A Kinesis video stream can support up to 50 tags.

", "error":{"httpStatusCode":400}, "exception":true }, @@ -1216,6 +1493,50 @@ "members":{ } }, + "UpdateImageGenerationConfigurationInput":{ + "type":"structure", + "members":{ + "StreamName":{ + "shape":"StreamName", + "documentation":"

The name of the stream from which to update the image generation configuration. You must specify either the StreamName or the StreamARN.

" + }, + "StreamARN":{ + "shape":"ResourceARN", + "documentation":"

The Amazon Resource Name (ARN) of the Kinesis video stream from where you want to update the image generation configuration. You must specify either the StreamName or the StreamARN.

" + }, + "ImageGenerationConfiguration":{ + "shape":"ImageGenerationConfiguration", + "documentation":"

The structure that contains the information required for the KVS images delivery. If the structure is null, the configuration will be deleted from the stream.

" + } + } + }, + "UpdateImageGenerationConfigurationOutput":{ + "type":"structure", + "members":{ + } + }, + "UpdateNotificationConfigurationInput":{ + "type":"structure", + "members":{ + "StreamName":{ + "shape":"StreamName", + "documentation":"

The name of the stream from which to update the notification configuration. You must specify either the StreamName or the StreamARN.

" + }, + "StreamARN":{ + "shape":"ResourceARN", + "documentation":"

The Amazon Resource Name (ARN) of the Kinesis video stream from where you want to update the notification configuration. You must specify either the StreamName or the StreamARN.

" + }, + "NotificationConfiguration":{ + "shape":"NotificationConfiguration", + "documentation":"

The structure containing the information required for notifications. If the structure is null, the configuration will be deleted from the stream.

" + } + } + }, + "UpdateNotificationConfigurationOutput":{ + "type":"structure", + "members":{ + } + }, "UpdateSignalingChannelInput":{ "type":"structure", "required":[ @@ -1287,6 +1608,11 @@ "documentation":"

The stream version that you specified is not the latest version. To get the latest version, use the DescribeStream API.

", "error":{"httpStatusCode":400}, "exception":true + }, + "WidthPixels":{ + "type":"integer", + "max":3840, + "min":1 } }, "documentation":"

" diff --git a/contrib/python/botocore/py3/botocore/data/s3/2006-03-01/service-2.json b/contrib/python/botocore/py3/botocore/data/s3/2006-03-01/service-2.json index 15426cf7ee6..03246b07bed 100644 --- a/contrib/python/botocore/py3/botocore/data/s3/2006-03-01/service-2.json +++ b/contrib/python/botocore/py3/botocore/data/s3/2006-03-01/service-2.json @@ -868,7 +868,7 @@ "requestUri":"/{Bucket}?lifecycle" }, "input":{"shape":"PutBucketLifecycleConfigurationRequest"}, - "documentation":"

Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle configuration. Keep in mind that this will overwrite an existing lifecycle configuration, so if you want to retain any configuration details, they must be included in the new lifecycle configuration. For information about lifecycle configuration, see Managing your storage lifecycle.

Bucket lifecycle configuration now supports specifying a lifecycle rule using an object key name prefix, one or more object tags, or a combination of both. Accordingly, this section describes the latest API. The previous version of the API supported filtering based only on an object key name prefix, which is supported for backward compatibility. For the related API description, see PutBucketLifecycle.

Rules

You specify the lifecycle configuration in your request body. The lifecycle configuration is specified as XML consisting of one or more rules. Each rule consists of the following:

For more information, see Object Lifecycle Management and Lifecycle Configuration Elements.

Permissions

By default, all Amazon S3 resources are private, including buckets, objects, and related subresources (for example, lifecycle configuration and website configuration). Only the resource owner (that is, the Amazon Web Services account that created it) can access the resource. The resource owner can optionally grant access permissions to others by writing an access policy. For this operation, a user must get the s3:PutLifecycleConfiguration permission.

You can also explicitly deny permissions. Explicit deny also supersedes any other permissions. If you want to block users or accounts from removing or deleting objects from your bucket, you must deny them permissions for the following actions:

For more information about permissions, see Managing Access Permissions to Your Amazon S3 Resources.

The following are related to PutBucketLifecycleConfiguration:

", + "documentation":"

Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle configuration. Keep in mind that this will overwrite an existing lifecycle configuration, so if you want to retain any configuration details, they must be included in the new lifecycle configuration. For information about lifecycle configuration, see Managing your storage lifecycle.

Bucket lifecycle configuration now supports specifying a lifecycle rule using an object key name prefix, one or more object tags, or a combination of both. Accordingly, this section describes the latest API. The previous version of the API supported filtering based only on an object key name prefix, which is supported for backward compatibility. For the related API description, see PutBucketLifecycle.

Rules

You specify the lifecycle configuration in your request body. The lifecycle configuration is specified as XML consisting of one or more rules. An Amazon S3 Lifecycle configuration can have up to 1,000 rules. This limit is not adjustable. Each rule consists of the following:

For more information, see Object Lifecycle Management and Lifecycle Configuration Elements.

Permissions

By default, all Amazon S3 resources are private, including buckets, objects, and related subresources (for example, lifecycle configuration and website configuration). Only the resource owner (that is, the Amazon Web Services account that created it) can access the resource. The resource owner can optionally grant access permissions to others by writing an access policy. For this operation, a user must get the s3:PutLifecycleConfiguration permission.

You can also explicitly deny permissions. Explicit deny also supersedes any other permissions. If you want to block users or accounts from removing or deleting objects from your bucket, you must deny them permissions for the following actions:

For more information about permissions, see Managing Access Permissions to Your Amazon S3 Resources.

The following are related to PutBucketLifecycleConfiguration:

", "httpChecksum":{ "requestAlgorithmMember":"ChecksumAlgorithm", "requestChecksumRequired":true @@ -1158,7 +1158,7 @@ "input":{"shape":"UploadPartRequest"}, "output":{"shape":"UploadPartOutput"}, "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadUploadPart.html", - "documentation":"

Uploads a part in a multipart upload.

In this operation, you provide part data in your request. However, you have an option to specify your existing Amazon S3 object as a data source for the part you are uploading. To upload a part from an existing object, you use the UploadPartCopy operation.

You must initiate a multipart upload (see CreateMultipartUpload) before you can upload any part. In response to your initiate request, Amazon S3 returns an upload ID, a unique identifier, that you must include in your upload part request.

Part numbers can be any number from 1 to 10,000, inclusive. A part number uniquely identifies a part and also defines its position within the object being created. If you upload a new part using the same part number that was used with a previous part, the previously uploaded part is overwritten. Each part must be at least 5 MB in size, except the last part. There is no size limit on the last part of your multipart upload.

To ensure that data is not corrupted when traversing the network, specify the Content-MD5 header in the upload part request. Amazon S3 checks the part data against the provided MD5 value. If they do not match, Amazon S3 returns an error.

If the upload request is signed with Signature Version 4, then Amazon Web Services S3 uses the x-amz-content-sha256 header as a checksum instead of Content-MD5. For more information see Authenticating Requests: Using the Authorization Header (Amazon Web Services Signature Version 4).

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

For more information on multipart uploads, go to Multipart Upload Overview in the Amazon S3 User Guide .

For information on the permissions required to use the multipart upload API, go to Multipart Upload and Permissions in the Amazon S3 User Guide.

You can optionally request server-side encryption where Amazon S3 encrypts your data as it writes it to disks in its data centers and decrypts it for you when you access it. You have the option of providing your own encryption key, or you can use the Amazon Web Services managed encryption keys. If you choose to provide your own encryption key, the request headers you provide in the request must match the headers you used in the request to initiate the upload by using CreateMultipartUpload. For more information, go to Using Server-Side Encryption in the Amazon S3 User Guide.

Server-side encryption is supported by the S3 Multipart Upload actions. Unless you are using a customer-provided encryption key, you don't need to specify the encryption parameters in each UploadPart request. Instead, you only need to specify the server-side encryption parameters in the initial Initiate Multipart request. For more information, see CreateMultipartUpload.

If you requested server-side encryption using a customer-provided encryption key in your initiate multipart upload request, you must provide identical encryption information in each part upload using the following headers.

Special Errors

Related Resources

", + "documentation":"

Uploads a part in a multipart upload.

In this operation, you provide part data in your request. However, you have an option to specify your existing Amazon S3 object as a data source for the part you are uploading. To upload a part from an existing object, you use the UploadPartCopy operation.

You must initiate a multipart upload (see CreateMultipartUpload) before you can upload any part. In response to your initiate request, Amazon S3 returns an upload ID, a unique identifier, that you must include in your upload part request.

Part numbers can be any number from 1 to 10,000, inclusive. A part number uniquely identifies a part and also defines its position within the object being created. If you upload a new part using the same part number that was used with a previous part, the previously uploaded part is overwritten.

For information about maximum and minimum part sizes and other multipart upload specifications, see Multipart upload limits in the Amazon S3 User Guide.

To ensure that data is not corrupted when traversing the network, specify the Content-MD5 header in the upload part request. Amazon S3 checks the part data against the provided MD5 value. If they do not match, Amazon S3 returns an error.

If the upload request is signed with Signature Version 4, then Amazon Web Services S3 uses the x-amz-content-sha256 header as a checksum instead of Content-MD5. For more information see Authenticating Requests: Using the Authorization Header (Amazon Web Services Signature Version 4).

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

For more information on multipart uploads, go to Multipart Upload Overview in the Amazon S3 User Guide .

For information on the permissions required to use the multipart upload API, go to Multipart Upload and Permissions in the Amazon S3 User Guide.

You can optionally request server-side encryption where Amazon S3 encrypts your data as it writes it to disks in its data centers and decrypts it for you when you access it. You have the option of providing your own encryption key, or you can use the Amazon Web Services managed encryption keys. If you choose to provide your own encryption key, the request headers you provide in the request must match the headers you used in the request to initiate the upload by using CreateMultipartUpload. For more information, go to Using Server-Side Encryption in the Amazon S3 User Guide.

Server-side encryption is supported by the S3 Multipart Upload actions. Unless you are using a customer-provided encryption key, you don't need to specify the encryption parameters in each UploadPart request. Instead, you only need to specify the server-side encryption parameters in the initial Initiate Multipart request. For more information, see CreateMultipartUpload.

If you requested server-side encryption using a customer-provided encryption key in your initiate multipart upload request, you must provide identical encryption information in each part upload using the following headers.

Special Errors

Related Resources

", "httpChecksum":{ "requestAlgorithmMember":"ChecksumAlgorithm", "requestChecksumRequired":false @@ -1173,7 +1173,7 @@ "input":{"shape":"UploadPartCopyRequest"}, "output":{"shape":"UploadPartCopyOutput"}, "documentationUrl":"http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadUploadPartCopy.html", - "documentation":"

Uploads a part by copying data from an existing object as data source. You specify the data source by adding the request header x-amz-copy-source in your request and a byte range by adding the request header x-amz-copy-source-range in your request.

The minimum allowable part size for a multipart upload is 5 MB. For more information about multipart upload limits, go to Quick Facts in the Amazon S3 User Guide.

Instead of using an existing object as part data, you might use the UploadPart action and provide data in your request.

You must initiate a multipart upload before you can upload any part. In response to your initiate request. Amazon S3 returns a unique identifier, the upload ID, that you must include in your upload part request.

For more information about using the UploadPartCopy operation, see the following:

Note the following additional considerations about the request headers x-amz-copy-source-if-match, x-amz-copy-source-if-none-match, x-amz-copy-source-if-unmodified-since, and x-amz-copy-source-if-modified-since:

Versioning

If your bucket has versioning enabled, you could have multiple versions of the same object. By default, x-amz-copy-source identifies the current version of the object to copy. If the current version is a delete marker and you don't specify a versionId in the x-amz-copy-source, Amazon S3 returns a 404 error, because the object does not exist. If you specify versionId in the x-amz-copy-source and the versionId is a delete marker, Amazon S3 returns an HTTP 400 error, because you are not allowed to specify a delete marker as a version for the x-amz-copy-source.

You can optionally specify a specific version of the source object to copy by adding the versionId subresource as shown in the following example:

x-amz-copy-source: /bucket/object?versionId=version id

Special Errors

Related Resources

" + "documentation":"

Uploads a part by copying data from an existing object as data source. You specify the data source by adding the request header x-amz-copy-source in your request and a byte range by adding the request header x-amz-copy-source-range in your request.

For information about maximum and minimum part sizes and other multipart upload specifications, see Multipart upload limits in the Amazon S3 User Guide.

Instead of using an existing object as part data, you might use the UploadPart action and provide data in your request.

You must initiate a multipart upload before you can upload any part. In response to your initiate request. Amazon S3 returns a unique identifier, the upload ID, that you must include in your upload part request.

For more information about using the UploadPartCopy operation, see the following:

Note the following additional considerations about the request headers x-amz-copy-source-if-match, x-amz-copy-source-if-none-match, x-amz-copy-source-if-unmodified-since, and x-amz-copy-source-if-modified-since:

Versioning

If your bucket has versioning enabled, you could have multiple versions of the same object. By default, x-amz-copy-source identifies the current version of the object to copy. If the current version is a delete marker and you don't specify a versionId in the x-amz-copy-source, Amazon S3 returns a 404 error, because the object does not exist. If you specify versionId in the x-amz-copy-source and the versionId is a delete marker, Amazon S3 returns an HTTP 400 error, because you are not allowed to specify a delete marker as a version for the x-amz-copy-source.

You can optionally specify a specific version of the source object to copy by adding the versionId subresource as shown in the following example:

x-amz-copy-source: /bucket/object?versionId=version id

Special Errors

Related Resources

" }, "WriteGetObjectResponse":{ "name":"WriteGetObjectResponse", @@ -6960,7 +6960,7 @@ "members":{ "NoncurrentDays":{ "shape":"Days", - "documentation":"

Specifies the number of days an object is noncurrent before Amazon S3 can perform the associated action. For information about the noncurrent days calculations, see How Amazon S3 Calculates When an Object Became Noncurrent in the Amazon S3 User Guide.

" + "documentation":"

Specifies the number of days an object is noncurrent before Amazon S3 can perform the associated action. The value must be a non-zero positive integer. For information about the noncurrent days calculations, see How Amazon S3 Calculates When an Object Became Noncurrent in the Amazon S3 User Guide.

" }, "NewerNoncurrentVersions":{ "shape":"VersionCount", @@ -7061,7 +7061,7 @@ }, "ETag":{ "shape":"ETag", - "documentation":"

The entity tag is a hash of the object. The ETag reflects changes only to the contents of an object, not its metadata. The ETag may or may not be an MD5 digest of the object data. Whether or not it is depends on how the object was created and how it is encrypted as described below:

" + "documentation":"

The entity tag is a hash of the object. The ETag reflects changes only to the contents of an object, not its metadata. The ETag may or may not be an MD5 digest of the object data. Whether or not it is depends on how the object was created and how it is encrypted as described below:

" }, "ChecksumAlgorithm":{ "shape":"ChecksumAlgorithmList", diff --git a/contrib/python/botocore/py3/botocore/data/sagemaker/2017-07-24/service-2.json b/contrib/python/botocore/py3/botocore/data/sagemaker/2017-07-24/service-2.json index 049ccf1e226..c0633ea1f7d 100644 --- a/contrib/python/botocore/py3/botocore/data/sagemaker/2017-07-24/service-2.json +++ b/contrib/python/botocore/py3/botocore/data/sagemaker/2017-07-24/service-2.json @@ -4357,6 +4357,25 @@ "AUC" ] }, + "AutoMLMetricExtendedEnum":{ + "type":"string", + "enum":[ + "Accuracy", + "MSE", + "F1", + "F1macro", + "AUC", + "RMSE", + "MAE", + "R2", + "BalancedAccuracy", + "Precision", + "PrecisionMacro", + "Recall", + "RecallMacro", + "LogLoss" + ] + }, "AutoMLNameContains":{ "type":"string", "max":63, @@ -18619,6 +18638,10 @@ "Set":{ "shape":"MetricSetSource", "documentation":"

The dataset split from which the AutoML job produced the metric.

" + }, + "StandardMetricName":{ + "shape":"AutoMLMetricExtendedEnum", + "documentation":"

The name of the standard metric.

" } }, "documentation":"

Information about the metric for a candidate produced by an AutoML job.

" @@ -22626,6 +22649,11 @@ "RSessionAppSettings":{ "type":"structure", "members":{ + "DefaultResourceSpec":{"shape":"ResourceSpec"}, + "CustomImages":{ + "shape":"CustomImages", + "documentation":"

A list of custom SageMaker images that are configured to run as a RSession app.

" + } }, "documentation":"

A collection of settings that apply to an RSessionGateway app.

" }, -- cgit v1.3