Merge pull request #199 from philnach/limittoendpoint

Add LimitToEndpoint setting addressing Exporting from JSON to Containerized cosmos db local not working as expected

Author: markjbrown

Extensions/Cosmos/Cosmos.DataTransfer.CosmosExtension/CosmosExtensionServices.cs

@@ -33,6 +33,7 @@ public static CosmosClient CreateClient(CosmosSettingsBase settings, string disp
                 AllowBulkExecution = true,
                 EnableContentResponseOnWrite = false,
                 Serializer = cosmosSerializer,
+                LimitToEndpoint = settings.LimitToEndpoint,
             };
 
             if (!string.IsNullOrEmpty(settings.WebProxy)){

Extensions/Cosmos/Cosmos.DataTransfer.CosmosExtension/CosmosSettingsBase.cs

@@ -16,6 +16,13 @@ public abstract class CosmosSettingsBase : IValidatableObject
         public string? AccountEndpoint { get; set; }
         public bool EnableInteractiveCredentials { get; set; }
         public bool InitClientEncryption { get; set; } = false;
+        
+        /// <summary>
+        /// <see cref="CosmosClientOptions.LimitToEndpoint"/>
+        /// When running the Azure Cosmos DB emulator in a Linux Container on Windows
+        /// a value of false results in failure to connect to Cosmos DB emulator. 
+        /// </summary>
+        public bool LimitToEndpoint { get; set; } = false;
 
         public virtual IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
         {

Extensions/Cosmos/README.md

@@ -85,6 +85,12 @@ Or with RBAC:
   - `Gateway` (default)
   - `Direct`
 
+- **`LimitToEndpoint`**: Optional, defaults to `false`. When the value of this property is false, the Cosmos DB SDK will automatically discover
+  write and read regions, and use them when the configured application region is not available. 
+  When set to `true`, availability is limited to the endpoint specified.
+  - **Note**: [CosmosClientOptions.LimitToEndpoint Property](https://learn.microsoft.com/dotnet/api/microsoft.azure.cosmos.cosmosclientoptions.limittoendpoint?view=azure-dotnet). When using the Cosmos DB Emulator Container for Linux it's been observed
+    setting the value to `true` enables import and export of data.  
+
 #### **Serverless Account**
 - **`IsServerlessAccount`**: Specifies whether the target account uses Serverless instead of Provisioned throughput, which affects the way containers are created.
   - **Note**: Serverless accounts cannot have shared throughput. See [Azure Cosmos DB serverless account type](https://learn.microsoft.com/azure/cosmos-db/serverless#use-serverless-resources).
@@ -115,6 +121,7 @@ Or with RBAC:
     "IgnoreNullValues": false,
     "IsServerlessAccount": false,
     "UseSharedThroughput": false,
-    "InitClientEncryption": false
+    "InitClientEncryption": false,
+    "LimitToEndpoint": false
 }
 ```