(DOCSP 25128): Document new support for s3RegionOverride (#1051)

* Document new support for s3RegionOverride

* tech review feedback

* copy review

* Update source/reference/k8s-operator-om-specification.txt

Author: davidhou17

source/includes/steps-deploy-k8s-opsmgr-http.yaml

@@ -236,7 +236,18 @@ content: |
       - string
       - Name of the |s3| or |s3|-compatible bucket that stores the
         database Backup snapshots.
-      - my-bucket
+      - ``my-bucket``
+
+    * - | ``spec``
+        | ``.backup``
+        | ``.s3Stores``
+        | ``.``:opsmgrkube:`~spec.backup.s3Stores.s3RegionOverride`
+      - string
+      - Region where your |s3|-compatible bucket resides. Use this 
+        field only if your |s3| store's 
+        :opsmgrkube:`s3BucketEndpoint <spec.backup.s3Stores.s3BucketEndpoint>`
+        doesn't include a region in its |url|. Don't use this field with |aws| |s3| buckets.
+      - ``us-east-1``
 
   To configure a blockstore, configure the following settings:
 

source/includes/steps-deploy-k8s-opsmgr-https.yaml

@@ -323,7 +323,18 @@ content: |
       - string
       - Name of the |s3| or |s3|-compatible bucket that stores the
         database Backup snapshots.
-      - my-bucket
+      - ``my-bucket``
+
+    * - | ``spec``
+        | ``.backup``
+        | ``.s3Stores``
+        | ``.``:opsmgrkube:`~spec.backup.s3Stores.s3RegionOverride`
+      - string
+      - Region where your |s3|-compatible bucket resides. Use this 
+        field only if your |s3| store's
+        :opsmgrkube:`s3BucketEndpoint <spec.backup.s3Stores.s3BucketEndpoint>`
+        doesn't include a region in its |url|. Don't use this field with |aws| |s3| buckets.
+      - ``us-east-1``
 
   To configure a blockstore, configure the following settings:
 

source/reference/k8s-operator-om-specification.txt

@@ -1282,6 +1282,12 @@ You can use |tls| for both |s3| and your application database, or for
    URL of the |aws| |s3| bucket or |s3|-compatible bucket that hosts the
    oplog store.
 
+   .. note::
+
+      If your endpoint doesn't include a region in its |url|, 
+      specify the :opsmgrkube:`s3RegionOverride <spec.backup.s3OpLogStores.s3RegionOverride>` 
+      field.
+
 .. opsmgrkube:: spec.backup.s3OpLogStores.s3BucketName
 
    *Type*: string
@@ -1291,6 +1297,18 @@ You can use |tls| for both |s3| and your application database, or for
    Name of the |aws| |s3| bucket or |s3|-compatible bucket that hosts
    the oplog store.
 
+.. opsmgrkube:: spec.backup.s3OpLogStores.s3RegionOverride
+
+   *Type*: string
+
+   Region where your |s3|-compatible bucket resides. Use this 
+   field only if your |s3| oplog store's
+   :opsmgrkube:`s3BucketEndpoint <spec.backup.s3OpLogStores.s3BucketEndpoint>`
+   doesn't support region scoping. Region scoping is when your endpoint doesn't include a region in its |url|.
+   
+   Don't use this field with |aws| |s3| buckets. For more information, see 
+   :opsmgr:`S3 Blockstore Configuration </reference/api/admin/backup/snapshot/s3Configs/create-one-s3-blockstore-configuration/>`.
+
 .. opsmgrkube:: spec.backup.s3Stores.customCertificate
 
    *Type*: boolean
@@ -1422,7 +1440,13 @@ You can use |tls| for both |s3| and your application database, or for
    *Required if you enable Backup using an S3 store.*
 
    URL of the |aws| |s3| bucket or |s3|-compatible bucket that hosts the
-   snapshot store.
+   snapshot store. 
+
+   .. note::
+
+      If your endpoint doesn't include a region in its |url|, 
+      specify the :opsmgrkube:`s3RegionOverride <spec.backup.s3Stores.s3RegionOverride>` 
+      field.
 
 .. opsmgrkube:: spec.backup.s3Stores.s3BucketName
 
@@ -1431,4 +1455,16 @@ You can use |tls| for both |s3| and your application database, or for
    *Required if you enable Backup using an S3 store.*
 
    Name of the |aws| |s3| bucket or |s3|-compatible bucket that hosts
-   the snapshot store.
+   the snapshot store.
+
+.. opsmgrkube:: spec.backup.s3Stores.s3RegionOverride
+
+   *Type*: string
+
+   Region where your |s3|-compatible bucket resides. Use this 
+   field only if your |s3| store's 
+   :opsmgrkube:`s3BucketEndpoint <spec.backup.s3Stores.s3BucketEndpoint>`
+   doesn't support region scoping. Region scoping is when your endpoint doesn't include a region in its |url|.
+   
+   Don't use this field with |aws| |s3| buckets. For more information, see 
+   :opsmgr:`S3 Blockstore Configuration </reference/api/admin/backup/snapshot/s3Configs/create-one-s3-blockstore-configuration/>`.