Merge main to live 2025-07-22

Author: azure-sdk

docs-ref-autogen/com.azure.cosmos.AvailabilityStrategy.yml

@@ -25,4 +25,4 @@ type: "class"
 desc: "The type Availability strategy."
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.BridgeInternal.yml

@@ -1057,4 +1057,4 @@ type: "class"
 desc: "DO NOT USE. This is meant to be used only internally as a bridge access to classes in com.azure.cosmos"
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.ChangeFeedProcessor.yml

@@ -70,4 +70,4 @@ type: "interface"
 desc: "Simple host for distributing change feed events across observers, simplifying the process of reading the change feeds and distributing the processing events across multiple consumers effectively.\n\nThere are four main components of implementing the change feed processor:\n\n *  The monitored container: the monitored container has the data from which the change feed is generated. Any inserts and updates to the monitored container are reflected in the change feed of the container.\n *  The lease container: the lease container acts as a state storage and coordinates processing the change feed across multiple workers. The lease container can be stored in the same account as the monitored container or in a separate account.\n *  The host: a host is an application instance that uses the change feed processor to listen for changes. Multiple instances with the same lease configuration can run in parallel, but each instance should have a different instance name.\n *  The delegate: the delegate is the code that defines what you, the developer, want to do with each batch of changes that the change feed processor reads.\n\nBelow is an example of building ChangeFeedProcessor for LatestVersion mode.\n\n```java\nChangeFeedProcessor changeFeedProcessor = new ChangeFeedProcessorBuilder()\n     .hostName(hostName)\n     .feedContainer(feedContainer)\n     .leaseContainer(leaseContainer)\n     .handleChanges(docs -> {\n         for (JsonNode item : docs) {\n             // Implementation for handling and processing of each JsonNode item goes here\n         }\n     })\n     .buildChangeFeedProcessor();\n```\n\nBelow is an example of building ChangeFeedProcessor for AllVersionsAndDeletes mode.\n\n```java\nChangeFeedProcessor changeFeedProcessor = new ChangeFeedProcessorBuilder()\n     .hostName(hostName)\n     .feedContainer(feedContainer)\n     .leaseContainer(leaseContainer)\n     .handleAllVersionsAndDeletesChanges(docs -> {\n         for (ChangeFeedProcessorItem item : docs) {\n             // Implementation for handling and processing of each ChangeFeedProcessorItem item goes here\n         }\n     })\n     .buildChangeFeedProcessor();\n```"
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.ChangeFeedProcessorBuilder.yml

@@ -156,4 +156,4 @@ type: "class"
 desc: "Helper class to build a <xref uid=\"com.azure.cosmos.ChangeFeedProcessor\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ChangeFeedProcessor\"></xref> instance. Below is an example of building ChangeFeedProcessor for LatestVersion mode.\n\n```java\nChangeFeedProcessor changeFeedProcessor = new ChangeFeedProcessorBuilder()\n     .hostName(hostName)\n     .feedContainer(feedContainer)\n     .leaseContainer(leaseContainer)\n     .handleChanges(docs -> {\n         for (JsonNode item : docs) {\n             // Implementation for handling and processing of each JsonNode item goes here\n         }\n     })\n     .buildChangeFeedProcessor();\n```\n\nBelow is an example of building ChangeFeedProcessor with throughput control for handleChanges.\n\n```java\nThroughputControlGroupConfig throughputControlGroupConfig =\n         new ThroughputControlGroupConfigBuilder()\n                 .groupName(\"cfp\")\n                 .targetThroughput(300)\n                 .priorityLevel(PriorityLevel.LOW)\n                 .build();\n ChangeFeedProcessor changeFeedProcessor = new ChangeFeedProcessorBuilder()\n         .hostName(hostName)\n         .feedContainer(feedContainer)\n         .leaseContainer(leaseContainer)\n         .handleChanges(docs -> {\n             for (JsonNode item : docs) {\n                 // Implementation for handling and processing of each JsonNode item goes here\n             }\n         })\n         .options(\n                 new ChangeFeedProcessorOptions()\n                         .setFeedPollThroughputControlConfig(throughputControlGroupConfig)\n         )\n         .buildChangeFeedProcessor();\n```\n\nBelow is an example of building ChangeFeedProcessor with throughput control for LatestVersion mode.\n\n```java\nThroughputControlGroupConfig throughputControlGroupConfig =\n         new ThroughputControlGroupConfigBuilder()\n                 .groupName(\"cfp\")\n                 .targetThroughput(300)\n                 .priorityLevel(PriorityLevel.LOW)\n                 .build();\n ChangeFeedProcessor changeFeedProcessor = new ChangeFeedProcessorBuilder()\n         .hostName(hostName)\n         .feedContainer(feedContainer)\n         .leaseContainer(leaseContainer)\n         .handleLatestVersionChanges(changeFeedProcessorItems -> {\n             for (ChangeFeedProcessorItem item : changeFeedProcessorItems) {\n                 // Implementation for handling and processing of each change feed item goes here\n             }\n         })\n         .options(\n                 new ChangeFeedProcessorOptions()\n                         .setFeedPollThroughputControlConfig(throughputControlGroupConfig)\n         )\n         .buildChangeFeedProcessor();\n```\n\nBelow is an example of building ChangeFeedProcessor for AllVersionsAndDeletes mode.\n\n```java\nChangeFeedProcessor changeFeedProcessor = new ChangeFeedProcessorBuilder()\n     .hostName(hostName)\n     .feedContainer(feedContainer)\n     .leaseContainer(leaseContainer)\n     .handleAllVersionsAndDeletesChanges(docs -> {\n         for (ChangeFeedProcessorItem item : docs) {\n             // Implementation for handling and processing of each ChangeFeedProcessorItem item goes here\n         }\n     })\n     .buildChangeFeedProcessor();\n```\n\nBelow is an example of building ChangeFeedProcessor for AllVersionsAndDeletes mode when also wishing to process a <xref uid=\"com.azure.cosmos.ChangeFeedProcessorContext\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ChangeFeedProcessorContext\"></xref>.\n\n```java\nChangeFeedProcessor changeFeedProcessor = new ChangeFeedProcessorBuilder()\n     .hostName(hostName)\n     .feedContainer(feedContainer)\n     .leaseContainer(leaseContainer)\n     .handleAllVersionsAndDeletesChanges((docs, context) -> {\n         for (ChangeFeedProcessorItem item : docs) {\n             // Implementation for handling and processing of each ChangeFeedProcessorItem item goes here\n         }\n         String leaseToken = context.getLeaseToken();\n         // Handling of the lease token corresponding to a batch of change feed processor item goes here\n     })\n     .buildChangeFeedProcessor();\n```"
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.ChangeFeedProcessorContext.yml

@@ -34,4 +34,4 @@ type: "interface"
 desc: "Encapsulates properties which are mapped to a batch of change feed documents processed when <xref uid=\"com.azure.cosmos.ChangeFeedProcessorBuilder.handleAllVersionsAndDeletesChanges*\" data-throw-if-not-resolved=\"false\" data-raw-source=\"ChangeFeedProcessorBuilder#handleAllVersionsAndDeletesChanges(BiConsumer)\"></xref> lambda is invoked.\n\nNOTE: This interface is not designed to be implemented by end users."
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.ConnectionMode.yml

@@ -68,4 +68,4 @@ methods:
 desc: "Represents the connection mode to be used by the client in the Azure Cosmos DB database service.\n\nDIRECT and GATEWAY connectivity modes are supported. DIRECT is the default."
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.ConsistencyLevel.yml

@@ -94,4 +94,4 @@ methods:
 desc: "Represents the consistency levels supported for Azure Cosmos DB client operations in the Azure Cosmos DB service.\n\nThe requested ConsistencyLevel must match or be weaker than that provisioned for the database account. Consistency levels by order of strength are STRONG, BOUNDED\\_STALENESS, SESSION and EVENTUAL. Refer to consistency level documentation for additional details: https://docs.microsoft.com/en-us/azure/cosmos-db/consistency-levels"
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.CosmosAsyncClient.yml

@@ -254,4 +254,4 @@ implements:
 - "<a href=\"https://docs.oracle.com/javase/8/docs/api/java/io/Closeable.html\">Closeable</a>"
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.CosmosAsyncClientEncryptionKey.yml

@@ -60,4 +60,4 @@ type: "class"
 desc: "The type Cosmos async clientEncryptionKey. This contains methods to operate on a cosmos clientEncryptionKey asynchronously"
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0

docs-ref-autogen/com.azure.cosmos.CosmosAsyncConflict.yml

@@ -64,4 +64,4 @@ type: "class"
 desc: "Read and delete conflicts"
 metadata: {}
 package: "com.azure.cosmos"
-artifact: com.azure:azure-cosmos:4.72.0
+artifact: com.azure:azure-cosmos:4.73.0