Adding checksum support for S3 PutBucketOwnershipControls API.

Author: aws-sdk-dotnet-automation

generator/ServiceModels/s3/s3-2006-03-01.api.json

@@ -328,7 +328,9 @@ internal bool IsSetKey()
         /// <summary>
         /// Gets and sets the property MaxParts. 
         /// <para>
-        /// Sets the maximum number of parts to return.
+        /// Sets the maximum number of parts to return. For more information, see 
+        /// <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html">
+        /// Uploading and copying objects using multipart upload in Amazon S3 </a> in the <i>Amazon Simple Storage Service user guide</i>.
         /// </para>
         /// </summary>
         public int? MaxParts
@@ -365,8 +367,9 @@ internal bool IsSetObjectAttributes()
         /// <summary>
         /// Gets and sets the property PartNumberMarker. 
         /// <para>
-        /// Specifies the part after which listing should begin. Only parts with higher part numbers
-        /// will be listed.
+        /// Specifies the part after which listing should begin. Only parts with higher part numbers will be listed. For more information, 
+        /// see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html">
+        /// Uploading and copying objects using multipart upload in Amazon S3 </a> in the <i>Amazon Simple Storage Service user guide</i>.
         /// </para>
         /// </summary>
         public int? PartNumberMarker

generator/ServiceModels/s3/s3-2006-03-01.docs.json

@@ -51,6 +51,9 @@ public IRequest Marshall(PutBucketOwnershipControlsRequest putBucketOwnershipCon
             if (putBucketOwnershipControlsRequest.IsSetExpectedBucketOwner())
                 request.Headers.Add(S3Constants.AmzHeaderExpectedBucketOwner, S3Transforms.ToStringValue(putBucketOwnershipControlsRequest.ExpectedBucketOwner));
 
+            if (putBucketOwnershipControlsRequest.IsSetChecksumAlgorithm())
+                request.Headers.Add(S3Constants.AmzHeaderSdkChecksumAlgorithm, S3Transforms.ToStringValue(putBucketOwnershipControlsRequest.ChecksumAlgorithm));
+
             request.ResourcePath = "/";
 
             request.AddSubResource("ownershipControls");
@@ -86,9 +89,13 @@ public IRequest Marshall(PutBucketOwnershipControlsRequest putBucketOwnershipCon
                 request.Content = System.Text.Encoding.UTF8.GetBytes(content);
                 request.Headers[HeaderKeys.ContentTypeHeader] = "application/xml";
 
-                // This operation is modeled with "httpChecksum":{"requestChecksumRequired":true}, but S3 doesn't validate the checksum at the moment. 
-                // We'll use the default behavior for now (which is to populate the Content-MD5 header).
-                ChecksumUtils.SetChecksumData(request);
+                ChecksumUtils.SetChecksumData(
+                    request,
+                    putBucketOwnershipControlsRequest.ChecksumAlgorithm,
+                    fallbackToMD5: false,
+                    isRequestChecksumRequired: true,
+                    headerName: S3Constants.AmzHeaderSdkChecksumAlgorithm
+                );
             }
             catch (EncoderFallbackException e)
             {

generator/ServiceModels/s3/s3-2006-03-01.examples.json

@@ -101,6 +101,16 @@ internal bool IsSetNoncurrentVersionExpiration()
 
         /// <summary>
         /// Filter identifying one or more objects to which the rule applies.
+        /// <para>
+        /// The <c>Filter</c> is used to identify objects that a Lifecycle Rule applies to. A <c>Filter</c> must have exactly one of 
+        /// <c>Prefix</c>, <c>Tag</c>, <c>ObjectSizeGreaterThan</c>, <c>ObjectSizeLessThan</c>, or <c>And</c> specified.
+        /// <c>Filter</c> is required if the <c>LifecycleRule</c> does not contain a <c>Prefix</c> element.
+        /// </para>
+        /// <note>
+        /// <para>
+        /// <c>Tag</c> filters are not supported for directory buckets.
+        /// </para> 
+        /// </note>
         /// </summary>
         public LifecycleFilter Filter
         {

generator/ServiceModels/s3/s3-2006-03-01.normal.json

@@ -57,6 +57,7 @@ public partial class PutBucketOwnershipControlsRequest : AmazonWebServiceRequest
         private string bucketName;
         private string expectedBucketOwner;
         private OwnershipControls ownershipControls;
+        private ChecksumAlgorithm _checksumAlgorithm;
 
         /// <summary>
         /// The name of the Amazon S3 bucket whose OwnershipControls you want to set
@@ -105,5 +106,36 @@ public OwnershipControls OwnershipControls
             get { return this.ownershipControls; }
             set { this.ownershipControls = value; }
         }
+
+        /// <summary>
+        /// Gets and sets the property ChecksumAlgorithm. 
+        /// <para>
+        /// Indicates the algorithm used to create the checksum for the object when you use the
+        /// SDK. This header will not provide any additional functionality if you don't use the
+        /// SDK. When you send this header, there must be a corresponding <c>x-amz-checksum-<i>algorithm</i>
+        /// </c> or <c>x-amz-trailer</c> header sent. Otherwise, Amazon S3 fails the
+        /// request with the HTTP status code <c>400 Bad Request</c>.
+        /// </para>
+        /// 
+        /// <para>
+        /// For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking
+        /// object integrity</a> in the <i>Amazon S3 User Guide</i>.
+        /// </para>
+        ///  
+        /// <para>
+        /// If you provide an individual checksum, Amazon S3 ignores any provided <c>ChecksumAlgorithm</c> parameter.
+        /// </para>
+        /// </summary>
+        public ChecksumAlgorithm ChecksumAlgorithm
+        {
+            get { return this._checksumAlgorithm; }
+            set { this._checksumAlgorithm = value; }
+        }
+
+        // Check to see if ChecksumAlgorithm property is set
+        internal bool IsSetChecksumAlgorithm()
+        {
+            return this._checksumAlgorithm != null;
+        }
     }
 }

sdk/src/Services/S3/Custom/Model/GetObjectAttributesRequest.cs

@@ -13699,13 +13699,13 @@ public virtual GetObjectAclResponse GetObjectAcl(GetObjectAclRequest request)
 
 
         /// <summary>
-        /// Retrieves all the metadata from an object without returning the object itself. This
-        /// operation is useful if you're interested only in an object's metadata. 
+        /// Retrieves all of the metadata from an object without returning the object itself.
+        /// This operation is useful if you're interested only in an object's metadata. 
         /// 
         ///  
         /// <para>
         ///  <c>GetObjectAttributes</c> combines the functionality of <c>HeadObject</c> and <c>ListParts</c>.
-        /// All of the data returned with each of those individual calls can be returned with
+        /// All of the data returned with both of those individual calls can be returned with
         /// a single call to <c>GetObjectAttributes</c>.
         /// </para>
         ///  <note> 
@@ -13722,14 +13722,33 @@ public virtual GetObjectAclResponse GetObjectAcl(GetObjectAclRequest request)
         ///  </note> <dl> <dt>Permissions</dt> <dd> <ul> <li> 
         /// <para>
         ///  <b>General purpose bucket permissions</b> - To use <c>GetObjectAttributes</c>, you
-        /// must have READ access to the object. The permissions that you need to use this operation
-        /// depend on whether the bucket is versioned. If the bucket is versioned, you need both
-        /// the <c>s3:GetObjectVersion</c> and <c>s3:GetObjectVersionAttributes</c> permissions
-        /// for this operation. If the bucket is not versioned, you need the <c>s3:GetObject</c>
-        /// and <c>s3:GetObjectAttributes</c> permissions. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying
-        /// Permissions in a Policy</a> in the <i>Amazon S3 User Guide</i>. If the object that
-        /// you request does not exist, the error Amazon S3 returns depends on whether you also
-        /// have the <c>s3:ListBucket</c> permission.
+        /// must have READ access to the object.
+        /// </para>
+        ///  
+        /// <para>
+        /// The other permissions that you need to use this operation depend on whether the bucket
+        /// is versioned and if a version ID is passed in the <c>GetObjectAttributes</c> request.
+        /// 
+        /// </para>
+        ///  <ul> <li> 
+        /// <para>
+        /// If you pass a version ID in your request, you need both the <c>s3:GetObjectVersion</c>
+        /// and <c>s3:GetObjectVersionAttributes</c> permissions.
+        /// </para>
+        ///  </li> <li> 
+        /// <para>
+        /// If you do not pass a version ID in your request, you need the <c>s3:GetObject</c>
+        /// and <c>s3:GetObjectAttributes</c> permissions. 
+        /// </para>
+        ///  </li> </ul> 
+        /// <para>
+        /// For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying
+        /// Permissions in a Policy</a> in the <i>Amazon S3 User Guide</i>.
+        /// </para>
+        ///  
+        /// <para>
+        /// If the object that you request does not exist, the error Amazon S3 returns depends
+        /// on whether you also have the <c>s3:ListBucket</c> permission.
         /// </para>
         ///  <ul> <li> 
         /// <para>
@@ -13776,10 +13795,11 @@ public virtual GetObjectAclResponse GetObjectAcl(GetObjectAclRequest request)
         /// </para>
         ///  </note> 
         /// <para>
-        /// If you encrypt an object by using server-side encryption with customer-provided encryption
-        /// keys (SSE-C) when you store the object in Amazon S3, then when you retrieve the metadata
-        /// from the object, you must use the following headers to provide the encryption key
-        /// for the server to be able to retrieve the object's metadata. The headers are: 
+        /// If you encrypted an object when you stored the object in Amazon S3 by using server-side
+        /// encryption with customer-provided encryption keys (SSE-C), then when you retrieve
+        /// the metadata from the object, you must use the following headers. These headers provide
+        /// the server with the encryption key required to retrieve the object's metadata. The
+        /// headers are: 
         /// </para>
         ///  <ul> <li> 
         /// <para>
@@ -13927,13 +13947,13 @@ public virtual GetObjectAttributesResponse GetObjectAttributes(GetObjectAttribut
 
 
         /// <summary>
-        /// Retrieves all the metadata from an object without returning the object itself. This
-        /// operation is useful if you're interested only in an object's metadata. 
+        /// Retrieves all of the metadata from an object without returning the object itself.
+        /// This operation is useful if you're interested only in an object's metadata. 
         /// 
         ///  
         /// <para>
         ///  <c>GetObjectAttributes</c> combines the functionality of <c>HeadObject</c> and <c>ListParts</c>.
-        /// All of the data returned with each of those individual calls can be returned with
+        /// All of the data returned with both of those individual calls can be returned with
         /// a single call to <c>GetObjectAttributes</c>.
         /// </para>
         ///  <note> 
@@ -13950,14 +13970,33 @@ public virtual GetObjectAttributesResponse GetObjectAttributes(GetObjectAttribut
         ///  </note> <dl> <dt>Permissions</dt> <dd> <ul> <li> 
         /// <para>
         ///  <b>General purpose bucket permissions</b> - To use <c>GetObjectAttributes</c>, you
-        /// must have READ access to the object. The permissions that you need to use this operation
-        /// depend on whether the bucket is versioned. If the bucket is versioned, you need both
-        /// the <c>s3:GetObjectVersion</c> and <c>s3:GetObjectVersionAttributes</c> permissions
-        /// for this operation. If the bucket is not versioned, you need the <c>s3:GetObject</c>
-        /// and <c>s3:GetObjectAttributes</c> permissions. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying
-        /// Permissions in a Policy</a> in the <i>Amazon S3 User Guide</i>. If the object that
-        /// you request does not exist, the error Amazon S3 returns depends on whether you also
-        /// have the <c>s3:ListBucket</c> permission.
+        /// must have READ access to the object.
+        /// </para>
+        ///  
+        /// <para>
+        /// The other permissions that you need to use this operation depend on whether the bucket
+        /// is versioned and if a version ID is passed in the <c>GetObjectAttributes</c> request.
+        /// 
+        /// </para>
+        ///  <ul> <li> 
+        /// <para>
+        /// If you pass a version ID in your request, you need both the <c>s3:GetObjectVersion</c>
+        /// and <c>s3:GetObjectVersionAttributes</c> permissions.
+        /// </para>
+        ///  </li> <li> 
+        /// <para>
+        /// If you do not pass a version ID in your request, you need the <c>s3:GetObject</c>
+        /// and <c>s3:GetObjectAttributes</c> permissions. 
+        /// </para>
+        ///  </li> </ul> 
+        /// <para>
+        /// For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying
+        /// Permissions in a Policy</a> in the <i>Amazon S3 User Guide</i>.
+        /// </para>
+        ///  
+        /// <para>
+        /// If the object that you request does not exist, the error Amazon S3 returns depends
+        /// on whether you also have the <c>s3:ListBucket</c> permission.
         /// </para>
         ///  <ul> <li> 
         /// <para>
@@ -14004,10 +14043,11 @@ public virtual GetObjectAttributesResponse GetObjectAttributes(GetObjectAttribut
         /// </para>
         ///  </note> 
         /// <para>
-        /// If you encrypt an object by using server-side encryption with customer-provided encryption
-        /// keys (SSE-C) when you store the object in Amazon S3, then when you retrieve the metadata
-        /// from the object, you must use the following headers to provide the encryption key
-        /// for the server to be able to retrieve the object's metadata. The headers are: 
+        /// If you encrypted an object when you stored the object in Amazon S3 by using server-side
+        /// encryption with customer-provided encryption keys (SSE-C), then when you retrieve
+        /// the metadata from the object, you must use the following headers. These headers provide
+        /// the server with the encryption key required to retrieve the object's metadata. The
+        /// headers are: 
         /// </para>
         ///  <ul> <li> 
         /// <para>