aws-sdk 2.1691.0 → 2.1693.0

package/README.md

@@ -1,215 +1,30 @@
-# AWS SDK for JavaScript
+# AWS SDK for JavaScript (v2)
 
 [![NPM version](https://img.shields.io/npm/v/aws-sdk.svg)](https://www.npmjs.com/package/aws-sdk)
-[![NPM downloads](https://img.shields.io/npm/dm/aws-sdk.svg)](https://www.npmjs.com/package/aws-sdk)
-[![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.svg)](https://gitter.im/aws/aws-sdk-js)
 
-[![Build Status](https://travis-ci.org/aws/aws-sdk-js.svg?branch=master)](https://travis-ci.org/aws/aws-sdk-js)
-[![Coverage Status](https://codecov.io/gh/aws/aws-sdk-js/branch/master/graph/badge.svg)](https://codecov.io/gh/aws/aws-sdk-js)
-[![Known Vulnerabilities](https://snyk.io/test/github/aws/aws-sdk-js/badge.svg)](https://snyk.io/test/github/aws/aws-sdk-js)
+## 🚫 End-of-support as of **September 8, 2025**
 
-## Version 2.x Upcoming End-of-Support
+The AWS SDK for JavaScript v2 has reached [end-of-support][v2-end-of-support] on **September 8, 2025**.
+It will no longer receive updates or releases. Previously published versions are available on npm at
+[aws-sdk][], and source code remains on GitHub at [aws/aws-sdk-js][].
 
-We [announced][v2-maintenance-mode] the upcoming end-of-support for AWS SDK for JavaScript v2.
-We recommend that you migrate to [AWS SDK for JavaScript v3][aws-sdk-js-v3].
-For dates, additional details, and information on how to migrate, please refer to the linked announcement.
-
-The **AWS SDK for JavaScript v3** is the latest and recommended version, 
-which has been GA since December 2020. Here is [why and how you should use
-**AWS SDK for JavaScript v3**][v3-recommended-blog]. You can try our experimental
-migration scripts in [aws-sdk-js-codemod][aws-sdk-js-codemod] to migrate
-your application from v2 to v3.
+We recommend that you migrate to [AWS SDK for JavaScript v3][v3-developer-guide], which has been GA
+since December 2020. Here is [why and how you should use it][v3-recommended-blog]. You can try
+migration scripts in [aws-sdk-js-codemod][] to migrate your application from v2 to v3.
 
 To get help with your migration, please follow our general guidelines to 
-[open an issue][v3-new-issue] and choose [guidance][open-issue-v3-guidance].
+[open an issue][v3-new-issue-migration].
 To give feedback on and report issues in the v3 repo, please refer to 
 [Giving feedback and contributing][v3-contributing].
 
-Watch this README and the [AWS Developer Tools Blog][aws-devtools-blog]
-for updates and announcements regarding the maintenance plans and timelines.
-
-A maintenance mode message may be emitted by this package on startup. 
-To suppress this message, use an environment variable:
-
-```sh
-AWS_SDK_JS_SUPPRESS_MAINTENANCE_MODE_MESSAGE=1 node my_program.js
-```
-
-or a JavaScript setting as follows:
-```js
-var SDK = require('aws-sdk');
-require('aws-sdk/lib/maintenance_mode_message').suppress = true;
-```
-
-[v3-new-issue]: https://github.com/aws/aws-sdk-js-v3/issues/new?assignees=&labels=needs-triage%2Cv2-v3-inconsistency&projects=&template=v2-to-v3-migration.yml&title=MIGRATION+ISSUE%3A+%5BYour+Title+Here%5D
-[v2-maintenance-mode]: https://aws.amazon.com/blogs/developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2
-[v3-recommended-blog]: https://aws.amazon.com/blogs/developer/why-and-how-you-should-use-aws-sdk-for-javascript-v3-on-node-js-18/
-[v3-contributing]: https://github.com/aws/aws-sdk-js-v3#giving-feedback-and-contributing
-[aws-sdk-js-v3]: https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html
-[aws-devtools-blog]: https://aws.amazon.com/blogs/developer/
-[open-issue-v3-guidance]: https://github.com/aws/aws-sdk-js-v3/issues/new?assignees=&labels=guidance%2C+needs-triage&template=---questions---help.md&title=
 [aws-sdk-js-codemod]: https://www.npmjs.com/package/aws-sdk-js-codemod
-
-## Table of Contents:
-* [Getting Started](#getting-Started)
-* [Getting Help](#getting-help)
-* [Contributing](#contributing)
-
-## Getting Started
-
-## How To Install
-
-### In the Browser
-
-To use the SDK in the browser, simply add the following script tag to your
-HTML pages:
-
-    <script src="https://sdk.amazonaws.com/js/aws-sdk-2.1691.0.min.js"></script>
-
-You can also build a custom browser SDK with your specified set of AWS services.
-This can allow you to reduce the SDK's size, specify different API versions of
-services, or use AWS services that don't currently support CORS if you are
-working in an environment that does not enforce CORS. To get started:
-
-http://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/building-sdk-for-browsers.html
-
-The AWS SDK is also compatible with [browserify](http://browserify.org).
-
-For browser-based web, mobile and hybrid apps, you can use [AWS Amplify Library](https://aws.github.io/aws-amplify/?utm_source=aws-js-sdk&utm_campaign=browser) which extends the AWS SDK and provides an easier and declarative interface.
-
-### In Node.js
-
-The preferred way to install the AWS SDK for Node.js is to use the
-[npm](http://npmjs.org) package manager for Node.js. Simply type the following
-into a terminal window:
-
-```sh
-npm install aws-sdk
-```
-
-### In React Native
-To use the SDK in a react native project, first install the SDK using npm:
-
-```sh
-npm install aws-sdk
-```
-
-Then within your application, you can reference the react native compatible version of the SDK with the following:
-
-```javascript
-var AWS = require('aws-sdk/dist/aws-sdk-react-native');
-```
-
-Alternatively, you can use [AWS Amplify Library](https://aws.github.io/aws-amplify/media/react_native_guide?utm_source=aws-js-sdk&utm_campaign=react-native) which extends AWS SDK and provides React Native UI components and CLI support to work with AWS services.
-
-### Using Bower
-
-You can also use [Bower](http://bower.io) to install the SDK by typing the
-following into a terminal window:
-
-```sh
-bower install aws-sdk-js
-```
-
-## Usage with TypeScript
-The AWS SDK for JavaScript bundles TypeScript definition files for use in TypeScript projects and to support tools that can read `.d.ts` files.
-Our goal is to keep these TypeScript definition files updated with each release for any public api.
-
-### Pre-requisites
-Before you can begin using these TypeScript definitions with your project, you need to make sure your project meets a few of these requirements:
-
- * Use latest version of TypeScript. We recommend 4.x+
- * Includes the TypeScript definitions for node. You can use npm to install this by typing the following into a terminal window:
-
-    ```sh
-    npm install --save-dev @types/node
-    ```
-
- * If you are targeting at es5 or older ECMA standards, your `tsconfig.json` has to include `'es5'` and `'es2015.promise'` under `compilerOptions.lib`.
- See [tsconfig.json](https://github.com/aws/aws-sdk-js/blob/master/ts/tsconfig.json) for an example.
-
-### In the Browser
-To use the TypeScript definition files with the global `AWS` object in a front-end project, add the following line to the top of your JavaScript file:
-
-```javascript
-/// <reference types="aws-sdk" />
-```
-
-This will provide support for the global `AWS` object.
-
-### In Node.js
-To use the TypeScript definition files within a Node.js project, simply import `aws-sdk` as you normally would.
-
-In a TypeScript file:
-
-```javascript
-// import entire SDK
-import AWS from 'aws-sdk';
-// import AWS object without services
-import AWS from 'aws-sdk/global';
-// import individual service
-import S3 from 'aws-sdk/clients/s3';
-```
-
-**NOTE:** You need to add `"esModuleInterop": true` to compilerOptions of your `tsconfig.json`. If not possible, use like `import * as AWS from 'aws-sdk'`.
-
-In a JavaScript file:
-
-```javascript
-// import entire SDK
-var AWS = require('aws-sdk');
-// import AWS object without services
-var AWS = require('aws-sdk/global');
-// import individual service
-var S3 = require('aws-sdk/clients/s3');
-```
-
-### With React
-
-To create React applications with AWS SDK, you can use [AWS Amplify Library](https://aws.github.io/aws-amplify/media/react_guide?utm_source=aws-js-sdk&utm_campaign=react) which provides React components and CLI support to work with AWS services.
-
-### With Angular
-Due to the SDK's reliance on node.js typings, you may encounter compilation 
-[issues](https://github.com/aws/aws-sdk-js/issues/1271) when using the
-typings provided by the SDK in an Angular project created using the Angular CLI.
-
-To resolve these issues, either add `"types": ["node"]` to the project's `tsconfig.app.json`
-file, or remove the `"types"` field entirely.
-
-[AWS Amplify Library](https://aws.github.io/aws-amplify/media/angular_guide?utm_source=aws-js-sdk&utm_campaign=angular) provides Angular components and CLI support to work with AWS services.
-
-### Known Limitations
-There are a few known limitations with the bundled TypeScript definitions at this time:
-
- * Service client typings reflect the latest `apiVersion`, regardless of which `apiVersion` is specified when creating a client.
- * Service-bound parameters use the `any` type.
-
-# Getting Help
-
-The best way to interact with our team is through GitHub. 
-You can [open an issue](https://github.com/aws/aws-sdk-js/issues/new/choose) and choose from one of our templates for 
-[bug reports](https://github.com/aws/aws-sdk-js/issues/new?assignees=&labels=bug%2C+needs-triage&template=---bug-report.md&title=), 
-[feature requests](https://github.com/aws/aws-sdk-js/issues/new?assignees=&labels=feature-request&template=---feature-request.md&title=) 
-or [guidance](https://github.com/aws/aws-sdk-js/issues/new?assignees=&labels=guidance%2C+needs-triage&template=---questions---help.md&title=). 
-You may also find help on community resources such as [StackOverFlow](https://stackoverflow.com/questions/tagged/aws-sdk-js) with the tag #aws-sdk-js.
-If you have a support plan with [AWS Support](https://aws.amazon.com/premiumsupport/), you can also create a new support case.
-
-Please make sure to check out our resources too before opening an issue:
-* Our [Developer Guide](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/welcome.html) and [API reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/)
-* Our [Changelog](https://github.com/aws/aws-sdk-js/blob/master/CHANGELOG.md) for recent changes.
-* Our [code examples](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/sdk-code-samples.html).
-
-Please see [SERVICES.md](https://github.com/aws/aws-sdk-js/blob/master/SERVICES.md) for a list of supported services.
-
-# Maintenance and support for SDK major versions
-For information about maintenance and support for SDK major versions and their underlying dependencies, see the following in the [AWS SDKs and Tools Shared Configuration and Credentials Reference Guide](https://docs.aws.amazon.com/credref/latest/refdocs/overview.html):
-* [AWS SDKs and Tools Maintenance Policy](https://docs.aws.amazon.com/credref/latest/refdocs/maint-policy.html)
-* [AWS SDKs and Tools Version Support Matrix](https://docs.aws.amazon.com/credref/latest/refdocs/version-support-matrix.html)
-
-
-
-# Contributing
-We welcome community contributions and pull requests. See [CONTRIBUTING.md](https://github.com/aws/aws-sdk-js/blob/master/CONTRIBUTING.md) for information on how to set up a development environment and submit code.
+[aws-sdk]: https://www.npmjs.com/package/aws-sdk
+[aws/aws-sdk-js]: https://github.com/aws/aws-sdk-js
+[v2-end-of-support]: https://aws.amazon.com/blogs/developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2
+[v3-contributing]: https://github.com/aws/aws-sdk-js-v3#giving-feedback-and-contributing
+[v3-developer-guide]: https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/welcome.html
+[v3-new-issue-migration]: https://github.com/aws/aws-sdk-js-v3/issues/new?assignees=&labels=needs-triage%2Cv2-v3-inconsistency&projects=&template=v2-to-v3-migration.yml&title=MIGRATION+ISSUE%3A+%5BYour+Title+Here%5D
+[v3-recommended-blog]: https://aws.amazon.com/blogs/developer/why-and-how-you-should-use-aws-sdk-for-javascript-v3-on-node-js-18/
 
 ## License
 

package/apis/s3-2006-03-01.examples.json

@@ -292,11 +292,10 @@
       {
         "input": {
           "Bucket": "examplebucket",
-          "Key": "HappyFace.jpg",
-          "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+          "Key": "HappyFace.jpg"
         },
         "output": {
-          "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+          "VersionId": "null"
         },
         "comments": {
           "input": {
@@ -304,17 +303,18 @@
           "output": {
           }
         },
-        "description": "The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.",
-        "id": "to-remove-tag-set-from-an-object-version-1483145285913",
-        "title": "To remove tag set from an object version"
+        "description": "The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.",
+        "id": "to-remove-tag-set-from-an-object-1483145342862",
+        "title": "To remove tag set from an object"
       },
       {
         "input": {
           "Bucket": "examplebucket",
-          "Key": "HappyFace.jpg"
+          "Key": "HappyFace.jpg",
+          "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
         },
         "output": {
-          "VersionId": "null"
+          "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
         },
         "comments": {
           "input": {
@@ -322,9 +322,9 @@
           "output": {
           }
         },
-        "description": "The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.",
-        "id": "to-remove-tag-set-from-an-object-1483145342862",
-        "title": "To remove tag set from an object"
+        "description": "The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.",
+        "id": "to-remove-tag-set-from-an-object-version-1483145285913",
+        "title": "To remove tag set from an object version"
       }
     ],
     "DeleteObjects": [
@@ -728,17 +728,18 @@
       {
         "input": {
           "Bucket": "examplebucket",
-          "Key": "HappyFace.jpg"
+          "Key": "SampleFile.txt",
+          "Range": "bytes=0-9"
         },
         "output": {
           "AcceptRanges": "bytes",
-          "ContentLength": "3191",
-          "ContentType": "image/jpeg",
-          "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
-          "LastModified": "Thu, 15 Dec 2016 01:19:41 GMT",
+          "ContentLength": "10",
+          "ContentRange": "bytes 0-9/43",
+          "ContentType": "text/plain",
+          "ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
+          "LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
           "Metadata": {
           },
-          "TagCount": 2,
           "VersionId": "null"
         },
         "comments": {
@@ -747,25 +748,24 @@
           "output": {
           }
         },
-        "description": "The following example retrieves an object for an S3 bucket.",
-        "id": "to-retrieve-an-object-1481827837012",
-        "title": "To retrieve an object"
+        "description": "The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range.",
+        "id": "to-retrieve-a-byte-range-of-an-object--1481832674603",
+        "title": "To retrieve a byte range of an object "
       },
       {
         "input": {
           "Bucket": "examplebucket",
-          "Key": "SampleFile.txt",
-          "Range": "bytes=0-9"
+          "Key": "HappyFace.jpg"
         },
         "output": {
           "AcceptRanges": "bytes",
-          "ContentLength": "10",
-          "ContentRange": "bytes 0-9/43",
-          "ContentType": "text/plain",
-          "ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
-          "LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
+          "ContentLength": "3191",
+          "ContentType": "image/jpeg",
+          "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
+          "LastModified": "Thu, 15 Dec 2016 01:19:41 GMT",
           "Metadata": {
           },
+          "TagCount": 2,
           "VersionId": "null"
         },
         "comments": {
@@ -774,9 +774,9 @@
           "output": {
           }
         },
-        "description": "The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range.",
-        "id": "to-retrieve-a-byte-range-of-an-object--1481832674603",
-        "title": "To retrieve a byte range of an object "
+        "description": "The following example retrieves an object for an S3 bucket.",
+        "id": "to-retrieve-an-object-1481827837012",
+        "title": "To retrieve an object"
       }
     ],
     "GetObjectAcl": [
@@ -840,20 +840,17 @@
       {
         "input": {
           "Bucket": "examplebucket",
-          "Key": "HappyFace.jpg"
+          "Key": "exampleobject",
+          "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
         },
         "output": {
           "TagSet": [
             {
-              "Key": "Key4",
-              "Value": "Value4"
-            },
-            {
-              "Key": "Key3",
-              "Value": "Value3"
+              "Key": "Key1",
+              "Value": "Value1"
             }
           ],
-          "VersionId": "null"
+          "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
         },
         "comments": {
           "input": {
@@ -861,24 +858,27 @@
           "output": {
           }
         },
-        "description": "The following example retrieves tag set of an object.",
-        "id": "to-retrieve-tag-set-of-an-object-1481833847896",
-        "title": "To retrieve tag set of an object"
+        "description": "The following example retrieves tag set of an object. The request specifies object version.",
+        "id": "to-retrieve-tag-set-of-a-specific-object-version-1483400283663",
+        "title": "To retrieve tag set of a specific object version"
       },
       {
         "input": {
           "Bucket": "examplebucket",
-          "Key": "exampleobject",
-          "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+          "Key": "HappyFace.jpg"
         },
         "output": {
           "TagSet": [
             {
-              "Key": "Key1",
-              "Value": "Value1"
+              "Key": "Key4",
+              "Value": "Value4"
+            },
+            {
+              "Key": "Key3",
+              "Value": "Value3"
             }
           ],
-          "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+          "VersionId": "null"
         },
         "comments": {
           "input": {
@@ -886,9 +886,9 @@
           "output": {
           }
         },
-        "description": "The following example retrieves tag set of an object. The request specifies object version.",
-        "id": "to-retrieve-tag-set-of-a-specific-object-version-1483400283663",
-        "title": "To retrieve tag set of a specific object version"
+        "description": "The following example retrieves tag set of an object.",
+        "id": "to-retrieve-tag-set-of-an-object-1481833847896",
+        "title": "To retrieve tag set of an object"
       }
     ],
     "GetObjectTorrent": [
@@ -1567,16 +1567,13 @@
     "PutObject": [
       {
         "input": {
-          "Body": "HappyFace.jpg",
+          "Body": "filetoupload",
           "Bucket": "examplebucket",
-          "Key": "HappyFace.jpg",
-          "ServerSideEncryption": "AES256",
-          "StorageClass": "STANDARD_IA"
+          "Key": "objectkey"
         },
         "output": {
           "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
-          "ServerSideEncryption": "AES256",
-          "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
+          "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
         },
         "comments": {
           "input": {
@@ -1584,19 +1581,23 @@
           "output": {
           }
         },
-        "description": "The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption.",
-        "id": "to-upload-an-object-(specify-optional-headers)",
-        "title": "To upload an object (specify optional headers)"
+        "description": "The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.",
+        "id": "to-create-an-object-1483147613675",
+        "title": "To create an object."
       },
       {
         "input": {
           "Body": "filetoupload",
           "Bucket": "examplebucket",
-          "Key": "objectkey"
+          "Key": "exampleobject",
+          "Metadata": {
+            "metadata1": "value1",
+            "metadata2": "value2"
+          }
         },
         "output": {
           "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
-          "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
+          "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
         },
         "comments": {
           "input": {
@@ -1604,9 +1605,9 @@
           "output": {
           }
         },
-        "description": "The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.",
-        "id": "to-create-an-object-1483147613675",
-        "title": "To create an object."
+        "description": "The following example creates an object. The request also specifies optional metadata. If the bucket is versioning enabled, S3 returns version ID in response.",
+        "id": "to-upload-object-and-specify-user-defined-metadata-1483396974757",
+        "title": "To upload object and specify user-defined metadata"
       },
       {
         "input": {
@@ -1630,14 +1631,14 @@
       },
       {
         "input": {
-          "Body": "c:\\HappyFace.jpg",
+          "ACL": "authenticated-read",
+          "Body": "filetoupload",
           "Bucket": "examplebucket",
-          "Key": "HappyFace.jpg",
-          "Tagging": "key1=value1&key2=value2"
+          "Key": "exampleobject"
         },
         "output": {
           "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
-          "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
+          "VersionId": "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr"
         },
         "comments": {
           "input": {
@@ -1645,20 +1646,22 @@
           "output": {
           }
         },
-        "description": "The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object.",
-        "id": "to-upload-an-object-and-specify-optional-tags-1481762310955",
-        "title": "To upload an object and specify optional tags"
+        "description": "The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.",
+        "id": "to-upload-an-object-and-specify-canned-acl-1483397779571",
+        "title": "To upload an object and specify canned ACL."
       },
       {
         "input": {
-          "ACL": "authenticated-read",
-          "Body": "filetoupload",
+          "Body": "HappyFace.jpg",
           "Bucket": "examplebucket",
-          "Key": "exampleobject"
+          "Key": "HappyFace.jpg",
+          "ServerSideEncryption": "AES256",
+          "StorageClass": "STANDARD_IA"
         },
         "output": {
           "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
-          "VersionId": "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr"
+          "ServerSideEncryption": "AES256",
+          "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
         },
         "comments": {
           "input": {
@@ -1666,23 +1669,20 @@
           "output": {
           }
         },
-        "description": "The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.",
-        "id": "to-upload-an-object-and-specify-canned-acl-1483397779571",
-        "title": "To upload an object and specify canned ACL."
+        "description": "The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption.",
+        "id": "to-upload-an-object-(specify-optional-headers)",
+        "title": "To upload an object (specify optional headers)"
       },
       {
         "input": {
-          "Body": "filetoupload",
+          "Body": "c:\\HappyFace.jpg",
           "Bucket": "examplebucket",
-          "Key": "exampleobject",
-          "Metadata": {
-            "metadata1": "value1",
-            "metadata2": "value2"
-          }
+          "Key": "HappyFace.jpg",
+          "Tagging": "key1=value1&key2=value2"
         },
         "output": {
           "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
-          "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
+          "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
         },
         "comments": {
           "input": {
@@ -1690,9 +1690,9 @@
           "output": {
           }
         },
-        "description": "The following example creates an object. The request also specifies optional metadata. If the bucket is versioning enabled, S3 returns version ID in response.",
-        "id": "to-upload-object-and-specify-user-defined-metadata-1483396974757",
-        "title": "To upload object and specify user-defined metadata"
+        "description": "The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object.",
+        "id": "to-upload-an-object-and-specify-optional-tags-1481762310955",
+        "title": "To upload an object and specify optional tags"
       },
       {
         "input": {
@@ -1826,14 +1826,15 @@
         "input": {
           "Bucket": "examplebucket",
           "CopySource": "/bucketname/sourceobjectkey",
+          "CopySourceRange": "bytes=1-100000",
           "Key": "examplelargeobject",
-          "PartNumber": "1",
+          "PartNumber": "2",
           "UploadId": "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--"
         },
         "output": {
           "CopyPartResult": {
-            "ETag": "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
-            "LastModified": "2016-12-29T21:24:43.000Z"
+            "ETag": "\"65d16d19e65a7508a51f043180edcc36\"",
+            "LastModified": "2016-12-29T21:44:28.000Z"
           }
         },
         "comments": {
@@ -1842,23 +1843,22 @@
           "output": {
           }
         },
-        "description": "The following example uploads a part of a multipart upload by copying data from an existing object as data source.",
-        "id": "to-upload-a-part-by-copying-data-from-an-existing-object-as-data-source-1483046746348",
-        "title": "To upload a part by copying data from an existing object as data source"
+        "description": "The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as data source.",
+        "id": "to-upload-a-part-by-copying-byte-range-from-an-existing-object-as-data-source-1483048068594",
+        "title": "To upload a part by copying byte range from an existing object as data source"
       },
       {
         "input": {
           "Bucket": "examplebucket",
           "CopySource": "/bucketname/sourceobjectkey",
-          "CopySourceRange": "bytes=1-100000",
           "Key": "examplelargeobject",
-          "PartNumber": "2",
+          "PartNumber": "1",
           "UploadId": "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--"
         },
         "output": {
           "CopyPartResult": {
-            "ETag": "\"65d16d19e65a7508a51f043180edcc36\"",
-            "LastModified": "2016-12-29T21:44:28.000Z"
+            "ETag": "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
+            "LastModified": "2016-12-29T21:24:43.000Z"
           }
         },
         "comments": {
@@ -1867,9 +1867,9 @@
           "output": {
           }
         },
-        "description": "The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as data source.",
-        "id": "to-upload-a-part-by-copying-byte-range-from-an-existing-object-as-data-source-1483048068594",
-        "title": "To upload a part by copying byte range from an existing object as data source"
+        "description": "The following example uploads a part of a multipart upload by copying data from an existing object as data source.",
+        "id": "to-upload-a-part-by-copying-data-from-an-existing-object-as-data-source-1483046746348",
+        "title": "To upload a part by copying data from an existing object as data source"
       }
     ]
   }