Excluded Regions Documentation Update (Azure#44844)

* Update java docs for exclude regions behavior

* React to comments

Author: tvaron3

sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/models/CosmosBatchRequestOptions.java

@@ -148,8 +148,10 @@ CosmosBatchRequestOptions setHeader(String name, String value) {
     }
 
     /**
-     * List of regions to exclude for the request/retries. Example "East US" or "East US, West US"
-     * These regions will be excluded from the preferred regions list
+     * List of regions to be excluded for the request/retries. Example "East US" or "East US, West US"
+     * These regions will be excluded from the preferred regions list. If all the regions are excluded,
+     * the request will be sent to the primary region for the account. The primary region is the write region in a
+     * single master account and the hub region in a multi-master account.
      *
      * @param excludeRegions list of regions
      * @return the {@link CosmosBatchRequestOptions}

sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/models/CosmosBulkExecutionOptions.java

@@ -299,7 +299,9 @@ public CosmosBulkExecutionOptions setThroughputControlGroupName(String throughpu
 
     /**
      * List of regions to exclude for the request/retries. Example "East US" or "East US, West US"
-     * These regions will be excluded from the preferred regions list
+     * These regions will be excluded from the preferred regions list. If all the regions are excluded,
+     * the request will be sent to the primary region for the account. The primary region is the write region in a
+     * single master account and the hub region in a multi-master account.
      *
      * @param excludeRegions list of regions
      * @return the {@link CosmosBulkExecutionOptions}

sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/models/CosmosChangeFeedRequestOptions.java

@@ -510,8 +510,10 @@ public CosmosChangeFeedRequestOptions setThroughputControlGroupName(String throu
     }
 
     /**
-     * List of regions to exclude for the request/retries. Example "East US" or "East US, West US"
-     * These regions will be excluded from the preferred regions list
+     * List of regions to be excluded for the request/retries. Example "East US" or "East US, West US"
+     * These regions will be excluded from the preferred regions list. If all the regions are excluded,
+     * the request will be sent to the primary region for the account. The primary region is the write region in a
+     * single master account and the hub region in a multi-master account.
      *
      * @param excludeRegions list of regions
      * @return the {@link CosmosChangeFeedRequestOptions}

sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/models/CosmosItemRequestOptions.java

@@ -401,8 +401,10 @@ public CosmosItemRequestOptions setCosmosEndToEndOperationLatencyPolicyConfig(Co
     }
 
     /**
-     * List of regions to exclude for the request/retries. Example "East US" or "East US, West US"
-     * These regions will be excluded from the preferred regions list
+     * List of regions to be excluded for the request/retries. Example "East US" or "East US, West US"
+     * These regions will be excluded from the preferred regions list. If all the regions are excluded,
+     * the request will be sent to the primary region for the account. The primary region is the write region in a
+     * single master account and the hub region in a multi-master account.
      *
      * @param excludeRegions list of regions
      * @return the {@link CosmosItemRequestOptions}

sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/models/CosmosQueryRequestOptions.java

@@ -216,7 +216,9 @@ public CosmosQueryRequestOptions setCosmosEndToEndOperationLatencyPolicyConfig(C
 
     /**
      * List of regions to be excluded for the request/retries. Example "East US" or "East US, West US"
-     * These regions will be excluded from the preferred regions list
+     * These regions will be excluded from the preferred regions list. If all the regions are excluded,
+     * the request will be sent to the primary region for the account. The primary region is the write region in a
+     * single master account and the hub region in a multi-master account.
      *
      * @param excludeRegions the regions to exclude
      * @return the {@link CosmosQueryRequestOptions}

sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/models/CosmosReadManyRequestOptions.java

@@ -138,7 +138,9 @@ public CosmosReadManyRequestOptions setCosmosEndToEndOperationLatencyPolicyConfi
 
     /**
      * List of regions to be excluded for the request/retries. Example "East US" or "East US, West US"
-     * These regions will be excluded from the preferred regions list
+     * These regions will be excluded from the preferred regions list. If all the regions are excluded,
+     * the request will be sent to the primary region for the account. The primary region is the write region in a
+     * single master account and the hub region in a multi-master account.
      *
      * @param excludeRegions the regions to exclude
      * @return the {@link CosmosReadManyRequestOptions}

sdk/cosmos/azure-cosmos/src/main/java/com/azure/cosmos/models/CosmosRequestOptions.java

@@ -94,7 +94,9 @@ public CosmosRequestOptions setDedicatedGatewayRequestOptions(DedicatedGatewayRe
     }
 
     /**
-     * Sets the exclude regions.
+     * Sets the exclude regions. If all the regions are excluded, the request will be sent to the primary region
+     * for the account. The primary region is the write region in a single master account and the hub region
+     * in a multi-master account.
      *
      * @param excludeRegions the ExcludeRegions.
      * @return current CosmosRequestOptions.