Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,14 +1,17 @@
# Release History

## 1.1.0-beta.2 (Unreleased)
## 1.1.0-beta.2 (2025-09-19)

### Features Added
- Azure Resource Manager Mongo Cluster client library for Java. This package contains Microsoft Azure SDK for Mongo Cluster Management SDK. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure Cosmos DB for MongoDB vCore resources including clusters and firewall rules. Package api-version 2025-08-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).

### Breaking Changes

### Bugs Fixed
#### `models.StorageProperties` was modified

### Other Changes
* `iops()` was removed
* `withThroughput(java.lang.Long)` was removed
* `withIops(java.lang.Long)` was removed
* `throughput()` was removed

## 1.1.0-beta.1 (2025-07-23)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Azure Resource Manager Mongo Cluster client library for Java.

This package contains Microsoft Azure SDK for Mongo Cluster Management SDK. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure Cosmos DB for MongoDB vCore resources including clusters and firewall rules. Package api-version 2025-07-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).
This package contains Microsoft Azure SDK for Mongo Cluster Management SDK. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure Cosmos DB for MongoDB vCore resources including clusters and firewall rules. Package api-version 2025-08-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt).

## We'd love to hear your feedback

Expand Down Expand Up @@ -32,7 +32,7 @@ Various documentation is available to help you get started
<dependency>
<groupId>com.azure.resourcemanager</groupId>
<artifactId>azure-resourcemanager-mongocluster</artifactId>
<version>1.1.0-beta.1</version>
<version>1.1.0-beta.2</version>
</dependency>
```
[//]: # ({x-version-update-end})
Expand Down
149 changes: 95 additions & 54 deletions sdk/mongocluster/azure-resourcemanager-mongocluster/SAMPLE.md

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
<packaging>jar</packaging>

<name>Microsoft Azure SDK for Mongo Cluster Management</name>
<description>This package contains Microsoft Azure SDK for Mongo Cluster Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure Cosmos DB for MongoDB vCore resources including clusters and firewall rules. Package api-version 2025-07-01-preview.</description>
<description>This package contains Microsoft Azure SDK for Mongo Cluster Management SDK. For documentation on how to use this package, please see https://aka.ms/azsdk/java/mgmt. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure Cosmos DB for MongoDB vCore resources including clusters and firewall rules. Package api-version 2025-08-01-preview.</description>
<url>https://github.com/Azure/azure-sdk-for-java</url>

<licenses>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -247,7 +247,7 @@ public UsersClient getUsers() {
this.defaultPollInterval = defaultPollInterval;
this.endpoint = endpoint;
this.subscriptionId = subscriptionId;
this.apiVersion = "2025-07-01-preview";
this.apiVersion = "2025-08-01-preview";
this.operations = new OperationsClientImpl(this);
this.mongoClusters = new MongoClustersClientImpl(this);
this.firewallRules = new FirewallRulesClientImpl(this);
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,16 +27,6 @@ public final class StorageProperties implements JsonSerializable<StorageProperti
*/
private StorageType type;

/*
* The IOPs of the storage assigned to each server. Only applicable if the type is 'PremiumSSDv2'.
*/
private Long iops;

/*
* The throughput of the storage assigned to each server. Only applicable if the type is 'PremiumSSDv2'.
*/
private Long throughput;

/**
* Creates an instance of StorageProperties class.
*/
Expand Down Expand Up @@ -83,50 +73,6 @@ public StorageProperties withType(StorageType type) {
return this;
}

/**
* Get the iops property: The IOPs of the storage assigned to each server. Only applicable if the type is
* 'PremiumSSDv2'.
*
* @return the iops value.
*/
public Long iops() {
return this.iops;
}

/**
* Set the iops property: The IOPs of the storage assigned to each server. Only applicable if the type is
* 'PremiumSSDv2'.
*
* @param iops the iops value to set.
* @return the StorageProperties object itself.
*/
public StorageProperties withIops(Long iops) {
this.iops = iops;
return this;
}

/**
* Get the throughput property: The throughput of the storage assigned to each server. Only applicable if the type
* is 'PremiumSSDv2'.
*
* @return the throughput value.
*/
public Long throughput() {
return this.throughput;
}

/**
* Set the throughput property: The throughput of the storage assigned to each server. Only applicable if the type
* is 'PremiumSSDv2'.
*
* @param throughput the throughput value to set.
* @return the StorageProperties object itself.
*/
public StorageProperties withThroughput(Long throughput) {
this.throughput = throughput;
return this;
}

/**
* Validates the instance.
*
Expand All @@ -143,8 +89,6 @@ public JsonWriter toJson(JsonWriter jsonWriter) throws IOException {
jsonWriter.writeStartObject();
jsonWriter.writeNumberField("sizeGb", this.sizeGb);
jsonWriter.writeStringField("type", this.type == null ? null : this.type.toString());
jsonWriter.writeNumberField("iops", this.iops);
jsonWriter.writeNumberField("throughput", this.throughput);
return jsonWriter.writeEndObject();
}

Expand All @@ -167,10 +111,6 @@ public static StorageProperties fromJson(JsonReader jsonReader) throws IOExcepti
deserializedStorageProperties.sizeGb = reader.getNullable(JsonReader::getLong);
} else if ("type".equals(fieldName)) {
deserializedStorageProperties.type = StorageType.fromString(reader.getString());
} else if ("iops".equals(fieldName)) {
deserializedStorageProperties.iops = reader.getNullable(JsonReader::getLong);
} else if ("throughput".equals(fieldName)) {
deserializedStorageProperties.throughput = reader.getNullable(JsonReader::getLong);
} else {
reader.skipChildren();
}
Expand Down

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
*/
public final class FirewallRulesCreateOrUpdateSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_FirewallRuleCreate.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_FirewallRuleCreate.json
*/
/**
* Sample code: Creates a firewall rule on a Mongo Cluster resource.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
*/
public final class FirewallRulesDeleteSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_FirewallRuleDelete.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_FirewallRuleDelete.json
*/
/**
* Sample code: Deletes a firewall rule on a Mongo Cluster resource.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
*/
public final class FirewallRulesGetSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_FirewallRuleGet.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_FirewallRuleGet.json
*/
/**
* Sample code: Gets a firewall rule on a Mongo Cluster resource.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
*/
public final class FirewallRulesListByMongoClusterSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_FirewallRuleList.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_FirewallRuleList.json
*/
/**
* Sample code: List the firewall rules on a Mongo Cluster resource.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
*/
public final class MongoClustersCheckNameAvailabilitySamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_NameAvailability.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_NameAvailability.json
*/
/**
* Sample code: Checks and confirms the Mongo Cluster name is availability for use.
Expand All @@ -26,7 +26,7 @@ public static void checksAndConfirmsTheMongoClusterNameIsAvailabilityForUse(
}

/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_NameAvailability_AlreadyExists.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_NameAvailability_AlreadyExists.json
*/
/**
* Sample code: Checks and returns that the Mongo Cluster name is already in-use.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@
*/
public final class MongoClustersCreateOrUpdateSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_Create_SSDv2.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_Create_SSDv2.json
*/
/**
* Sample code: Creates a new Mongo Cluster resource with Premium SSDv2 storage.
Expand All @@ -53,10 +53,7 @@ public static void createsANewMongoClusterResourceWithPremiumSSDv2Storage(
.withServerVersion("5.0")
.withHighAvailability(
new HighAvailabilityProperties().withTargetMode(HighAvailabilityMode.ZONE_REDUNDANT_PREFERRED))
.withStorage(new StorageProperties().withSizeGb(32L)
.withType(StorageType.PREMIUM_SSDV2)
.withIops(3000L)
.withThroughput(125L))
.withStorage(new StorageProperties().withSizeGb(32L).withType(StorageType.PREMIUM_SSDV2))
.withSharding(new ShardingProperties().withShardCount(1))
.withCompute(new ComputeProperties().withTier("M30"))
.withAuthConfig(
Expand All @@ -65,7 +62,7 @@ public static void createsANewMongoClusterResourceWithPremiumSSDv2Storage(
}

/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_CreateGeoReplica_CMK.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_CreateGeoReplica_CMK.json
*/
/**
* Sample code: Creates a replica Mongo Cluster resource with Customer Managed Key encryption from a source
Expand Down Expand Up @@ -98,7 +95,7 @@ public static void createsAReplicaMongoClusterResourceWithCustomerManagedKeyEncr
}

/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_Create_CMK.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_Create_CMK.json
*/
/**
* Sample code: Creates a new Mongo Cluster resource with Customer Managed Key encryption.
Expand Down Expand Up @@ -133,7 +130,7 @@ public static void createsANewMongoClusterResourceWithCustomerManagedKeyEncrypti
}

/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_CreateGeoReplica.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_CreateGeoReplica.json
*/
/**
* Sample code: Creates a replica Mongo Cluster resource from a source resource.
Expand All @@ -154,7 +151,7 @@ public static void createsAReplicaMongoClusterResourceFromASourceResource(
}

/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_CreatePITR.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_CreatePITR.json
*/
/**
* Sample code: Creates a Mongo Cluster resource from a point in time restore.
Expand All @@ -171,12 +168,39 @@ public static void createsAMongoClusterResourceFromAPointInTimeRestore(
.withRestoreParameters(new MongoClusterRestoreParameters()
.withPointInTimeUTC(OffsetDateTime.parse("2023-01-13T20:07:35Z"))
.withSourceResourceId(
"/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestResourceGroup/providers/Microsoft.DocumentDB/mongoClusters/myOtherMongoCluster")))
"/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestResourceGroup/providers/Microsoft.DocumentDB/mongoClusters/myOtherMongoCluster"))
.withAdministrator(
new AdministratorProperties().withUserName("mongoAdmin").withPassword("fakeTokenPlaceholder")))
.create();
}

/*
* x-ms-original-file: 2025-08-01-preview/MongoClusters_CreatePITR_EntraAuth.json
*/
/**
* Sample code: Creates a Mongo Cluster resource from a point in time restore with Microsoft Entra ID authentication
* mode enabled.
*
* @param manager Entry point to MongoClusterManager.
*/
public static void createsAMongoClusterResourceFromAPointInTimeRestoreWithMicrosoftEntraIDAuthenticationModeEnabled(
com.azure.resourcemanager.mongocluster.MongoClusterManager manager) {
manager.mongoClusters()
.define("myMongoCluster")
.withRegion("westus2")
.withExistingResourceGroup("TestResourceGroup")
.withProperties(new MongoClusterProperties().withCreateMode(CreateMode.POINT_IN_TIME_RESTORE)
.withRestoreParameters(new MongoClusterRestoreParameters()
.withPointInTimeUTC(OffsetDateTime.parse("2023-01-13T20:07:35Z"))
.withSourceResourceId(
"/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestResourceGroup/providers/Microsoft.DocumentDB/mongoClusters/myOtherMongoCluster"))
.withAuthConfig(
new AuthConfigProperties().withAllowedModes(Arrays.asList(AuthenticationMode.MICROSOFT_ENTRA_ID))))
.create();
}

/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_Create.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_Create.json
*/
/**
* Sample code: Creates a new Mongo Cluster resource.
Expand Down Expand Up @@ -204,7 +228,7 @@ public static void createsAMongoClusterResourceFromAPointInTimeRestore(
}

/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_CreatePITR_CMK.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_CreatePITR_CMK.json
*/
/**
* Sample code: Creates a Mongo Cluster resource with Customer Managed Key encryption from a point in time restore.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
*/
public final class MongoClustersDeleteSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_Delete.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_Delete.json
*/
/**
* Sample code: Deletes a Mongo Cluster resource.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
*/
public final class MongoClustersGetByResourceGroupSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_Get.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_Get.json
*/
/**
* Sample code: Gets a Mongo Cluster resource.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
*/
public final class MongoClustersListByResourceGroupSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_ListByResourceGroup.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_ListByResourceGroup.json
*/
/**
* Sample code: Lists the Mongo Cluster resources in a resource group.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
*/
public final class MongoClustersListConnectionStringsSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_ListConnectionStrings.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_ListConnectionStrings.json
*/
/**
* Sample code: List the available connection strings for the Mongo Cluster resource.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
*/
public final class MongoClustersListSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_List.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_List.json
*/
/**
* Sample code: Lists the Mongo Cluster resources in a subscription.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
*/
public final class MongoClustersPromoteSamples {
/*
* x-ms-original-file: 2025-07-01-preview/MongoClusters_ForcePromoteReplica.json
* x-ms-original-file: 2025-08-01-preview/MongoClusters_ForcePromoteReplica.json
*/
/**
* Sample code: Promotes a replica Mongo Cluster resource to a primary role.
Expand Down
Loading