AWS S3 Control Update: Added 34 new S3 Storage Lens metrics to support additional customer use cases.

Author: AWS

.changes/next-release/feature-AWSS3Control-3e66b82.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "AWS S3 Control",
+    "contributor": "",
+    "description": "Added 34 new S3 Storage Lens metrics to support additional customer use cases."
+}

services/s3control/src/main/resources/codegen-resources/service-2.json

@@ -649,7 +649,7 @@
       },
       "input":{"shape":"GetStorageLensConfigurationRequest"},
       "output":{"shape":"GetStorageLensConfigurationResult"},
-      "documentation":"<p>Gets the Amazon S3 Storage Lens configuration. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html\">Assessing your storage activity and usage with Amazon S3 Storage Lens </a> in the <i>Amazon S3 User Guide</i>.</p> <note> <p>To use this action, you must have permission to perform the <code>s3:GetStorageLensConfiguration</code> action. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html\">Setting permissions to use Amazon S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>.</p> </note>",
+      "documentation":"<p>Gets the Amazon S3 Storage Lens configuration. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html\">Assessing your storage activity and usage with Amazon S3 Storage Lens </a> in the <i>Amazon S3 User Guide</i>. For a complete list of S3 Storage Lens metrics, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html\">S3 Storage Lens metrics glossary</a> in the <i>Amazon S3 User Guide</i>.</p> <note> <p>To use this action, you must have permission to perform the <code>s3:GetStorageLensConfiguration</code> action. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html\">Setting permissions to use Amazon S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>.</p> </note>",
       "endpoint":{
         "hostPrefix":"{AccountId}."
       },
@@ -970,7 +970,7 @@
         "locationName":"PutStorageLensConfigurationRequest",
         "xmlNamespace":{"uri":"http://awss3control.amazonaws.com/doc/2018-08-20/"}
       },
-      "documentation":"<p>Puts an Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html\">Working with Amazon S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>.</p> <note> <p>To use this action, you must have permission to perform the <code>s3:PutStorageLensConfiguration</code> action. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html\">Setting permissions to use Amazon S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>.</p> </note>",
+      "documentation":"<p>Puts an Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens.html\">Working with Amazon S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>. For a complete list of S3 Storage Lens metrics, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html\">S3 Storage Lens metrics glossary</a> in the <i>Amazon S3 User Guide</i>.</p> <note> <p>To use this action, you must have permission to perform the <code>s3:PutStorageLensConfiguration</code> action. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/storage_lens_iam_permissions.html\">Setting permissions to use Amazon S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>.</p> </note>",
       "endpoint":{
         "hostPrefix":"{AccountId}."
       },
@@ -1113,24 +1113,56 @@
       "members":{
         "ActivityMetrics":{
           "shape":"ActivityMetrics",
-          "documentation":"<p>A container for the S3 Storage Lens activity metrics.</p>"
+          "documentation":"<p>A container for S3 Storage Lens activity metrics.</p>"
         },
         "BucketLevel":{
           "shape":"BucketLevel",
           "documentation":"<p>A container for the S3 Storage Lens bucket-level configuration.</p>"
+        },
+        "AdvancedCostOptimizationMetrics":{
+          "shape":"AdvancedCostOptimizationMetrics",
+          "documentation":"<p>A container for S3 Storage Lens advanced cost-optimization metrics.</p>"
+        },
+        "AdvancedDataProtectionMetrics":{
+          "shape":"AdvancedDataProtectionMetrics",
+          "documentation":"<p>A container for S3 Storage Lens advanced data-protection metrics.</p>"
+        },
+        "DetailedStatusCodesMetrics":{
+          "shape":"DetailedStatusCodesMetrics",
+          "documentation":"<p>A container for detailed status code metrics. </p>"
         }
       },
-      "documentation":"<p>A container for the account level Amazon S3 Storage Lens configuration.</p>"
+      "documentation":"<p>A container for the account-level Amazon S3 Storage Lens configuration.</p> <p>For more information about S3 Storage Lens, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html\">Assessing your storage activity and usage with S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>. For a complete list of S3 Storage Lens metrics, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html\">S3 Storage Lens metrics glossary</a> in the <i>Amazon S3 User Guide</i>.</p>"
     },
     "ActivityMetrics":{
       "type":"structure",
       "members":{
         "IsEnabled":{
           "shape":"IsEnabled",
-          "documentation":"<p>A container for whether the activity metrics are enabled.</p>"
+          "documentation":"<p>A container that indicates whether activity metrics are enabled.</p>"
+        }
+      },
+      "documentation":"<p>The container element for Amazon S3 Storage Lens activity metrics. Activity metrics show details about how your storage is requested, such as requests (for example, All requests, Get requests, Put requests), bytes uploaded or downloaded, and errors.</p> <p>For more information about S3 Storage Lens, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html\">Assessing your storage activity and usage with S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>. For a complete list of S3 Storage Lens metrics, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html\">S3 Storage Lens metrics glossary</a> in the <i>Amazon S3 User Guide</i>.</p>"
+    },
+    "AdvancedCostOptimizationMetrics":{
+      "type":"structure",
+      "members":{
+        "IsEnabled":{
+          "shape":"IsEnabled",
+          "documentation":"<p>A container that indicates whether advanced cost-optimization metrics are enabled.</p>"
+        }
+      },
+      "documentation":"<p>The container element for Amazon S3 Storage Lens advanced cost-optimization metrics. Advanced cost-optimization metrics provide insights that you can use to manage and optimize your storage costs, for example, lifecycle rule counts for transitions, expirations, and incomplete multipart uploads.</p> <p>For more information about S3 Storage Lens, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html\">Assessing your storage activity and usage with S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>. For a complete list of S3 Storage Lens metrics, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html\">S3 Storage Lens metrics glossary</a> in the <i>Amazon S3 User Guide</i>.</p>"
+    },
+    "AdvancedDataProtectionMetrics":{
+      "type":"structure",
+      "members":{
+        "IsEnabled":{
+          "shape":"IsEnabled",
+          "documentation":"<p>A container that indicates whether advanced data-protection metrics are enabled.</p>"
         }
       },
-      "documentation":"<p>A container for the activity metrics.</p>"
+      "documentation":"<p>The container element for Amazon S3 Storage Lens advanced data-protection metrics. Advanced data-protection metrics provide insights that you can use to perform audits and protect your data, for example replication rule counts within and across Regions.</p> <p>For more information about S3 Storage Lens, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html\">Assessing your storage activity and usage with S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>. For a complete list of S3 Storage Lens metrics, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html\">S3 Storage Lens metrics glossary</a> in the <i>Amazon S3 User Guide</i>.</p>"
     },
     "Alias":{
       "type":"string",
@@ -1296,14 +1328,26 @@
       "members":{
         "ActivityMetrics":{
           "shape":"ActivityMetrics",
-          "documentation":"<p>A container for the bucket-level activity metrics for Amazon S3 Storage Lens</p>"
+          "documentation":"<p>A container for the bucket-level activity metrics for S3 Storage Lens.</p>"
         },
         "PrefixLevel":{
           "shape":"PrefixLevel",
-          "documentation":"<p>A container for the bucket-level prefix-level metrics for S3 Storage Lens</p>"
+          "documentation":"<p>A container for the prefix-level metrics for S3 Storage Lens. </p>"
+        },
+        "AdvancedCostOptimizationMetrics":{
+          "shape":"AdvancedCostOptimizationMetrics",
+          "documentation":"<p>A container for bucket-level advanced cost-optimization metrics for S3 Storage Lens.</p>"
+        },
+        "AdvancedDataProtectionMetrics":{
+          "shape":"AdvancedDataProtectionMetrics",
+          "documentation":"<p>A container for bucket-level advanced data-protection metrics for S3 Storage Lens.</p>"
+        },
+        "DetailedStatusCodesMetrics":{
+          "shape":"DetailedStatusCodesMetrics",
+          "documentation":"<p>A container for bucket-level detailed status code metrics for S3 Storage Lens.</p>"
         }
       },
-      "documentation":"<p>A container for the bucket-level configuration.</p>"
+      "documentation":"<p>A container for the bucket-level configuration for Amazon S3 Storage Lens.</p> <p>For more information about S3 Storage Lens, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html\">Assessing your storage activity and usage with S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>.</p>"
     },
     "BucketLocationConstraint":{
       "type":"string",
@@ -2068,6 +2112,16 @@
         }
       }
     },
+    "DetailedStatusCodesMetrics":{
+      "type":"structure",
+      "members":{
+        "IsEnabled":{
+          "shape":"IsEnabled",
+          "documentation":"<p>A container that indicates whether detailed status code metrics are enabled.</p>"
+        }
+      },
+      "documentation":"<p>The container element for Amazon S3 Storage Lens detailed status code metrics. Detailed status code metrics generate metrics for HTTP status codes, such as <code>200 OK</code>, <code>403 Forbidden</code>, <code>503 Service Unavailable</code> and others. </p> <p>For more information about S3 Storage Lens, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html\">Assessing your storage activity and usage with S3 Storage Lens</a> in the <i>Amazon S3 User Guide</i>. For a complete list of S3 Storage Lens metrics, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html\">S3 Storage Lens metrics glossary</a> in the <i>Amazon S3 User Guide</i>.</p>"
+    },
     "Endpoints":{
       "type":"map",
       "key":{"shape":"NonEmptyMaxLength64String"},
@@ -3168,7 +3222,7 @@
         },
         "S3PutObjectAcl":{
           "shape":"S3SetObjectAclOperation",
-          "documentation":"<p>Directs the specified job to run a PUT Object acl call on every object in the manifest.</p>",
+          "documentation":"<p>Directs the specified job to run a <code>PutObjectAcl</code> call on every object in the manifest.</p>",
           "box":true
         },
         "S3PutObjectTagging":{
@@ -4172,26 +4226,26 @@
       "members":{
         "BlockPublicAcls":{
           "shape":"Setting",
-          "documentation":"<p>Specifies whether Amazon S3 should block public access control lists (ACLs) for buckets in this account. Setting this element to <code>TRUE</code> causes the following behavior:</p> <ul> <li> <p>PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.</p> </li> <li> <p>PUT Object calls fail if the request includes a public ACL.</p> </li> <li> <p>PUT Bucket calls fail if the request includes a public ACL.</p> </li> </ul> <p>Enabling this setting doesn't affect existing policies or ACLs.</p> <p>This is not supported for Amazon S3 on Outposts.</p>",
+          "documentation":"<p>Specifies whether Amazon S3 should block public access control lists (ACLs) for buckets in this account. Setting this element to <code>TRUE</code> causes the following behavior:</p> <ul> <li> <p> <code>PutBucketAcl</code> and <code>PutObjectAcl</code> calls fail if the specified ACL is public.</p> </li> <li> <p>PUT Object calls fail if the request includes a public ACL.</p> </li> <li> <p>PUT Bucket calls fail if the request includes a public ACL.</p> </li> </ul> <p>Enabling this setting doesn't affect existing policies or ACLs.</p> <p>This property is not supported for Amazon S3 on Outposts.</p>",
           "locationName":"BlockPublicAcls"
         },
         "IgnorePublicAcls":{
           "shape":"Setting",
-          "documentation":"<p>Specifies whether Amazon S3 should ignore public ACLs for buckets in this account. Setting this element to <code>TRUE</code> causes Amazon S3 to ignore all public ACLs on buckets in this account and any objects that they contain. </p> <p>Enabling this setting doesn't affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set.</p> <p>This is not supported for Amazon S3 on Outposts.</p>",
+          "documentation":"<p>Specifies whether Amazon S3 should ignore public ACLs for buckets in this account. Setting this element to <code>TRUE</code> causes Amazon S3 to ignore all public ACLs on buckets in this account and any objects that they contain. </p> <p>Enabling this setting doesn't affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set.</p> <p>This property is not supported for Amazon S3 on Outposts.</p>",
           "locationName":"IgnorePublicAcls"
         },
         "BlockPublicPolicy":{
           "shape":"Setting",
-          "documentation":"<p>Specifies whether Amazon S3 should block public bucket policies for buckets in this account. Setting this element to <code>TRUE</code> causes Amazon S3 to reject calls to PUT Bucket policy if the specified bucket policy allows public access. </p> <p>Enabling this setting doesn't affect existing bucket policies.</p> <p>This is not supported for Amazon S3 on Outposts.</p>",
+          "documentation":"<p>Specifies whether Amazon S3 should block public bucket policies for buckets in this account. Setting this element to <code>TRUE</code> causes Amazon S3 to reject calls to PUT Bucket policy if the specified bucket policy allows public access. </p> <p>Enabling this setting doesn't affect existing bucket policies.</p> <p>This property is not supported for Amazon S3 on Outposts.</p>",
           "locationName":"BlockPublicPolicy"
         },
         "RestrictPublicBuckets":{
           "shape":"Setting",
-          "documentation":"<p>Specifies whether Amazon S3 should restrict public bucket policies for buckets in this account. Setting this element to <code>TRUE</code> restricts access to buckets with public policies to only Amazon Web Service principals and authorized users within this account.</p> <p>Enabling this setting doesn't affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked.</p> <p>This is not supported for Amazon S3 on Outposts.</p>",
+          "documentation":"<p>Specifies whether Amazon S3 should restrict public bucket policies for buckets in this account. Setting this element to <code>TRUE</code> restricts access to buckets with public policies to only Amazon Web Service principals and authorized users within this account.</p> <p>Enabling this setting doesn't affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked.</p> <p>This property is not supported for Amazon S3 on Outposts.</p>",
           "locationName":"RestrictPublicBuckets"
         }
       },
-      "documentation":"<p>The <code>PublicAccessBlock</code> configuration that you want to apply to this Amazon S3 account. You can enable the configuration options in any combination. For more information about when Amazon S3 considers a bucket or object public, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status\">The Meaning of \"Public\"</a> in the <i>Amazon S3 User Guide</i>.</p> <p>This is not supported for Amazon S3 on Outposts.</p>"
+      "documentation":"<p>The <code>PublicAccessBlock</code> configuration that you want to apply to this Amazon S3 account. You can enable the configuration options in any combination. For more information about when Amazon S3 considers a bucket or object public, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status\">The Meaning of \"Public\"</a> in the <i>Amazon S3 User Guide</i>.</p> <p>This data type is not supported for Amazon S3 on Outposts.</p>"
     },
     "PublicAccessBlockEnabled":{"type":"boolean"},
     "PutAccessPointConfigurationForObjectLambdaRequest":{
@@ -4817,7 +4871,7 @@
       "members":{
         "TargetResource":{
           "shape":"S3BucketArnString",
-          "documentation":"<p>Specifies the destination bucket ARN for the batch copy operation. For example, to copy objects to a bucket named \"destinationBucket\", set the TargetResource to \"arn:aws:s3:::destinationBucket\".</p>"
+          "documentation":"<p>Specifies the destination bucket ARN for the batch copy operation. For example, to copy objects to a bucket named <code>destinationBucket</code>, set the <code>TargetResource</code> property to <code>arn:aws:s3:::destinationBucket</code>.</p>"
         },
         "CannedAccessControlList":{
           "shape":"S3CannedAccessControlList",
@@ -5205,7 +5259,7 @@
           "documentation":"<p/>"
         }
       },
-      "documentation":"<p>Contains the configuration parameters for a Set Object ACL operation. S3 Batch Operations passes every object to the underlying PUT Object acl API. For more information about the parameters for this operation, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTacl.html\">PUT Object acl</a>.</p>"
+      "documentation":"<p>Contains the configuration parameters for a Set Object ACL operation. S3 Batch Operations passes every object to the underlying <code>PutObjectAcl</code> API. For more information about the parameters for this operation, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTacl.html\"> <code>PutObjectAcl</code> </a>.</p>"
     },
     "S3SetObjectLegalHoldOperation":{
       "type":"structure",
@@ -5265,14 +5319,14 @@
       "members":{
         "Key":{
           "shape":"TagKeyString",
-          "documentation":"<p/>"
+          "documentation":"<p>Key of the tag</p>"
         },
         "Value":{
           "shape":"TagValueString",
-          "documentation":"<p/>"
+          "documentation":"<p>Value of the tag</p>"
         }
       },
-      "documentation":"<p/>"
+      "documentation":"<p>A container for a key-value name pair.</p>"
     },
     "S3TagSet":{
       "type":"list",