DOCSP-11889 doc for additional storage classes (#64)

* DOCSP-11889 doc for additional storage classes

DOCSP-11889 fixing links

DOCSP-11889 minor fixes

* DOCSP-11889 update to limitations page

* Apply suggestions from code review

updates from copy review

Co-authored-by: Melissa Mahoney <[email protected]>

* DOCPS-11889 updates for copy review

* DOCSP-11889 updates for external review

* DOCSP-11889 minor update

Co-authored-by: Melissa Mahoney <[email protected]>

Author: kanchana-mongodb

source/reference/cli/stores/create-store.txt

@@ -53,7 +53,7 @@ Syntax
 
       .. code-block:: sh 
 
-         db.runCommand({ createStore: <store-name>, provider: <storage-provider>, region: <region-name>, bucket: <bucket-name>, delimiter: <delimiter>, prefix: <prefix> })
+         db.runCommand({ createStore: <store-name>, provider: <storage-provider>, region: <region-name>, bucket: <bucket-name>, additionalStorageClasses: [ <storage-classes> ], delimiter: <delimiter>, prefix: <prefix> })
 
    .. tab:: Atlas Configuration 
       :tabid: atlas 
@@ -123,6 +123,28 @@ Parameters
              the configured |aws| |iam| credentials.
            - yes
 
+         * - ``additionalStorageClasses`` 
+           - array of strings 
+           - Array of |aws| |s3| `storage classes 
+             <https://aws.amazon.com/s3/storage-classes/>`__. {+adl+} will 
+             include the files in these storage classes in the query results. 
+             Valid values are: 
+
+             - ``INTELLIGENT_TIERING`` to include files in the `Intelligent 
+               Tiering <https://aws.amazon.com/s3/storage-classes/#Unknown_or_changing_access>`__ 
+               storage class.
+             - ``STANDARD_IA`` to include files in the `Standard-Infrequent Access 
+               <https://aws.amazon.com/s3/storage-classes/#Infrequent_access>`__ 
+               storage class.
+
+             .. note:: 
+
+                Files in the `Standard 
+                <https://aws.amazon.com/s3/storage-classes/#General_purpose>`__ 
+                storage class are supported by default.
+
+           - no
+
          * - ``delimiter`` 
            - string 
            - Character used to separate path segments in the {+data-lake-store+}. 
@@ -189,6 +211,7 @@ fails, see :ref:`dl-create-store-cmd-errors` for recommended solutions.
             "name": "<store-name>",
             "region": "<region-name>",
             "bucket": "<bucket-name>",
+            "additionalStorageClasses": ["<storage-classes>"]
             "delimiter": "<delimiter>",
             "prefix": "<prefix>",
             "provider": "<storage-provider>"
@@ -245,7 +268,7 @@ The following example uses the ``createStore`` command to create a new
       .. code-block:: json 
 
          use sample
-         db.runCommand({ createStore: "myStore", provider: "s3", region: "us-east-1", bucket: "my-data-lake", prefix: "/sample" })
+         db.runCommand({ createStore: "myStore", provider: "s3", region: "us-east-1", bucket: "my-data-lake", "additionalStorageClasses" : ["STANDARD_IA","INTELLIGENT_TIERING"] prefix: "/sample" })
 
       The previous command prints the following: 
 
@@ -258,6 +281,10 @@ The following example uses the ``createStore`` command to create a new
              "name": "myStore",
              "region": "us-east-1",
              "bucket": "my-data-lake",
+             "additionalStorageClasses" : [
+			         "STANDARD_IA",
+			         "INTELLIGENT_TIERING"
+		         ],
              "delimiter": "/",
              "prefix": "/sample",
              "provider": "s3"

source/reference/format/data-lake-configuration.txt

@@ -75,6 +75,9 @@ Click on the tab below to learn more about the {+dl+} configuration for that dat
                   "provider" : "s3",
                   "region" : "us-east-1",
                   "bucket" : "datacenter-alpha",
+                  "additionalStorageClasses" : [
+                    "STANDARD_IA"
+                  ],
                   "prefix" : "/metrics",
                   "delimiter" : "/"
                 }
@@ -253,6 +256,9 @@ to run federated queries.
             "provider" : "s3",
             "region" : "us-east-1",
             "bucket" : "datacenter-alpha",
+            "additionalStorageClasses" : [
+              "STANDARD_IA"
+            ],
             "prefix" : "/metrics",
             "delimiter" : "/"
           },
@@ -332,6 +338,7 @@ The {+data-lake-short+} configuration has the following format:
                "provider": "<string>",
                "region" : "<string>", 
                "bucket" : "<string>",
+               "additionalStorageClasses" : ["<string>"],
                "prefix" : "<string>", 
                "includeTags": <boolean>, 
                "delimiter": "<string>"
@@ -470,6 +477,7 @@ The {+data-lake-short+} configuration has the following format:
              "provider" : "<string>",
              "region" : "<string>",
              "bucket" : "<string>",
+             "additionalStorageClasses" : ["<string>"],
              "prefix" : "<string>",
              "delimiter" : "<string>",
              "includeTags": <boolean>
@@ -543,6 +551,26 @@ The {+data-lake-short+} configuration has the following format:
          bucket which {+data-lake-short+} can access given the
          configured |aws| IAM credentials.
 
+      .. datalakeconf:: stores.[n].additionalStorageClasses
+
+         *Optional.* Array of |aws| |s3| `storage classes 
+         <https://aws.amazon.com/s3/storage-classes/>`__. {+adl+} will 
+         include the files in these storage classes in the query results. 
+         Valid values are: 
+
+         - ``INTELLIGENT_TIERING`` to include files in the `Intelligent 
+           Tiering <https://aws.amazon.com/s3/storage-classes/#Unknown_or_changing_access>`__ 
+           storage class
+         - ``STANDARD_IA`` to include files in the `Standard-Infrequent Access 
+           <https://aws.amazon.com/s3/storage-classes/#Infrequent_access>`__ 
+           storage class
+
+         .. note:: 
+
+            Files in the `Standard 
+            <https://aws.amazon.com/s3/storage-classes/#General_purpose>`__ 
+            storage class are supported by default.
+
       .. datalakeconf:: stores.[n].prefix
 
          *Optional.* Prefix {+data-lake-short+} applies when searching for 

source/supported-unsupported/limitations.txt

@@ -7,9 +7,11 @@
 .. meta::
    :keywords: |data-lake| limitations
 
-|service| |data-lake| only supports `Amazon S3 Standard storage class 
-<https://aws.amazon.com/s3/storage-classes/?nc=sn&loc=3#General_purpose>`__. 
-|data-lake| does not support the following features:
+|service| |data-lake| only supports Amazon S3 `Standard 
+<https://aws.amazon.com/s3/storage-classes/?nc=sn&loc=3#General_purpose>`__, 
+`Intelligent Tiering <https://aws.amazon.com/s3/storage-classes/#Unknown_or_changing_access>`__ 
+and `Standard-Infrequent Access <https://aws.amazon.com/s3/storage-classes/#Infrequent_access>`__ 
+storage classes. |data-lake| does not support the following features:
 
 * Creating Indexes
 * Monitoring |data-lakes| with |service| monitoring tools