@pulumi/mongodbatlas 3.39.0-alpha.1766556689 → 4.0.0

package/getAdvancedCluster.js

@@ -12,7 +12,7 @@ const utilities = require("./utilities");
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const exampleAdvancedCluster = new mongodbatlas.AdvancedCluster("example", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "cluster-test",
  *     clusterType: "REPLICASET",
@@ -28,19 +28,58 @@ const utilities = require("./utilities");
  *         }],
  *     }],
  * });
- * const example = mongodbatlas.getAdvancedClusterOutput({
- *     projectId: exampleAdvancedCluster.projectId,
- *     name: exampleAdvancedCluster.name,
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
  * });
  * ```
  *
+ * ## Example using effective fields with auto-scaling
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as mongodbatlas from "@pulumi/mongodbatlas";
+ *
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
+ *     projectId: "<YOUR-PROJECT-ID>",
+ *     name: "auto-scale-cluster",
+ *     clusterType: "REPLICASET",
+ *     useEffectiveFields: true,
+ *     replicationSpecs: [{
+ *         regionConfigs: [{
+ *             electableSpecs: {
+ *                 instanceSize: "M10",
+ *                 nodeCount: 3,
+ *             },
+ *             autoScaling: {
+ *                 computeEnabled: true,
+ *                 computeScaleDownEnabled: true,
+ *                 computeMinInstanceSize: "M10",
+ *                 computeMaxInstanceSize: "M30",
+ *             },
+ *             providerName: "AWS",
+ *             priority: 7,
+ *             regionName: "US_EAST_1",
+ *         }],
+ *     }],
+ * });
+ * // Read effective values after Atlas auto-scales the cluster
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
+ *     useEffectiveFields: true,
+ * });
+ * export const configuredInstanceSize = _this.apply(_this => _this.replicationSpecs?.[0]?.regionConfigs?.[0]?.electableSpecs?.instanceSize);
+ * export const actualInstanceSize = _this.apply(_this => _this.replicationSpecs?.[0]?.regionConfigs?.[0]?.effectiveElectableSpecs?.instanceSize);
+ * ```
+ *
  * ## Example using latest sharding configurations with independent shard scaling in the cluster
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const exampleAdvancedCluster = new mongodbatlas.AdvancedCluster("example", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "cluster-test",
  *     backupEnabled: false,
@@ -72,10 +111,9 @@ const utilities = require("./utilities");
  *         },
  *     ],
  * });
- * const example = mongodbatlas.getAdvancedClusterOutput({
- *     projectId: exampleAdvancedCluster.projectId,
- *     name: exampleAdvancedCluster.name,
- *     useReplicationSpecPerShard: true,
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
  * });
  * ```
  *
@@ -85,7 +123,7 @@ const utilities = require("./utilities");
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const example_flex = new mongodbatlas.AdvancedCluster("example-flex", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "flex-cluster",
  *     clusterType: "REPLICASET",
@@ -98,9 +136,9 @@ const utilities = require("./utilities");
  *         }],
  *     }],
  * });
- * const example = mongodbatlas.getAdvancedClusterOutput({
- *     projectId: example_flex.projectId,
- *     name: example_flex.name,
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
  * });
  * ```
  */
@@ -108,9 +146,8 @@ function getAdvancedCluster(args, opts) {
     opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
     return pulumi.runtime.invoke("mongodbatlas:index/getAdvancedCluster:getAdvancedCluster", {
         "name": args.name,
-        "pitEnabled": args.pitEnabled,
         "projectId": args.projectId,
-        "useReplicationSpecPerShard": args.useReplicationSpecPerShard,
+        "useEffectiveFields": args.useEffectiveFields,
     }, opts);
 }
 exports.getAdvancedCluster = getAdvancedCluster;
@@ -121,7 +158,7 @@ exports.getAdvancedCluster = getAdvancedCluster;
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const exampleAdvancedCluster = new mongodbatlas.AdvancedCluster("example", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "cluster-test",
  *     clusterType: "REPLICASET",
@@ -137,10 +174,49 @@ exports.getAdvancedCluster = getAdvancedCluster;
  *         }],
  *     }],
  * });
- * const example = mongodbatlas.getAdvancedClusterOutput({
- *     projectId: exampleAdvancedCluster.projectId,
- *     name: exampleAdvancedCluster.name,
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
+ * });
+ * ```
+ *
+ * ## Example using effective fields with auto-scaling
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as mongodbatlas from "@pulumi/mongodbatlas";
+ *
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
+ *     projectId: "<YOUR-PROJECT-ID>",
+ *     name: "auto-scale-cluster",
+ *     clusterType: "REPLICASET",
+ *     useEffectiveFields: true,
+ *     replicationSpecs: [{
+ *         regionConfigs: [{
+ *             electableSpecs: {
+ *                 instanceSize: "M10",
+ *                 nodeCount: 3,
+ *             },
+ *             autoScaling: {
+ *                 computeEnabled: true,
+ *                 computeScaleDownEnabled: true,
+ *                 computeMinInstanceSize: "M10",
+ *                 computeMaxInstanceSize: "M30",
+ *             },
+ *             providerName: "AWS",
+ *             priority: 7,
+ *             regionName: "US_EAST_1",
+ *         }],
+ *     }],
+ * });
+ * // Read effective values after Atlas auto-scales the cluster
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
+ *     useEffectiveFields: true,
  * });
+ * export const configuredInstanceSize = _this.apply(_this => _this.replicationSpecs?.[0]?.regionConfigs?.[0]?.electableSpecs?.instanceSize);
+ * export const actualInstanceSize = _this.apply(_this => _this.replicationSpecs?.[0]?.regionConfigs?.[0]?.effectiveElectableSpecs?.instanceSize);
  * ```
  *
  * ## Example using latest sharding configurations with independent shard scaling in the cluster
@@ -149,7 +225,7 @@ exports.getAdvancedCluster = getAdvancedCluster;
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const exampleAdvancedCluster = new mongodbatlas.AdvancedCluster("example", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "cluster-test",
  *     backupEnabled: false,
@@ -181,10 +257,9 @@ exports.getAdvancedCluster = getAdvancedCluster;
  *         },
  *     ],
  * });
- * const example = mongodbatlas.getAdvancedClusterOutput({
- *     projectId: exampleAdvancedCluster.projectId,
- *     name: exampleAdvancedCluster.name,
- *     useReplicationSpecPerShard: true,
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
  * });
  * ```
  *
@@ -194,7 +269,7 @@ exports.getAdvancedCluster = getAdvancedCluster;
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const example_flex = new mongodbatlas.AdvancedCluster("example-flex", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "flex-cluster",
  *     clusterType: "REPLICASET",
@@ -207,9 +282,9 @@ exports.getAdvancedCluster = getAdvancedCluster;
  *         }],
  *     }],
  * });
- * const example = mongodbatlas.getAdvancedClusterOutput({
- *     projectId: example_flex.projectId,
- *     name: example_flex.name,
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
  * });
  * ```
  */
@@ -217,9 +292,8 @@ function getAdvancedClusterOutput(args, opts) {
     opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
     return pulumi.runtime.invokeOutput("mongodbatlas:index/getAdvancedCluster:getAdvancedCluster", {
         "name": args.name,
-        "pitEnabled": args.pitEnabled,
         "projectId": args.projectId,
-        "useReplicationSpecPerShard": args.useReplicationSpecPerShard,
+        "useEffectiveFields": args.useEffectiveFields,
     }, opts);
 }
 exports.getAdvancedClusterOutput = getAdvancedClusterOutput;

package/getAdvancedCluster.js.map

@@ -1 +1 @@
-{"version":3,"file":"getAdvancedCluster.js","sourceRoot":"","sources":["../getAdvancedCluster.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AAGzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkGG;AACH,SAAgB,kBAAkB,CAAC,IAA4B,EAAE,IAA2B;IACxF,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,0DAA0D,EAAE;QACrF,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,4BAA4B,EAAE,IAAI,CAAC,0BAA0B;KAChE,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AARD,gDAQC;AAiID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkGG;AACH,SAAgB,wBAAwB,CAAC,IAAkC,EAAE,IAAiC;IAC1G,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,0DAA0D,EAAE;QAC3F,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,4BAA4B,EAAE,IAAI,CAAC,0BAA0B;KAChE,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AARD,4DAQC"}
+{"version":3,"file":"getAdvancedCluster.js","sourceRoot":"","sources":["../getAdvancedCluster.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AAGzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwIG;AACH,SAAgB,kBAAkB,CAAC,IAA4B,EAAE,IAA2B;IACxF,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,0DAA0D,EAAE;QACrF,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,oBAAoB,EAAE,IAAI,CAAC,kBAAkB;KAChD,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAPD,gDAOC;AA2HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwIG;AACH,SAAgB,wBAAwB,CAAC,IAAkC,EAAE,IAAiC;IAC1G,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,0DAA0D,EAAE;QAC3F,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,oBAAoB,EAAE,IAAI,CAAC,kBAAkB;KAChD,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAPD,4DAOC"}

package/getAdvancedClusters.d.ts

@@ -1,12 +1,8 @@
 import * as pulumi from "@pulumi/pulumi";
 import * as outputs from "./types/output";
 /**
- * ## # Data Source: mongodbatlas.getAdvancedClusters
- *
  * `mongodbatlas.getAdvancedClusters` returns all Advanced Clusters for a project_id.
  *
- * This page describes the current version of `mongodbatlas.getAdvancedClusters`, the page for the **Preview for MongoDB Atlas Provider 2.0.0** can be found here.
- *
  * > **NOTE:** Groups and projects are synonymous terms. You may find groupId in the official documentation.
  *
  * > **IMPORTANT:**
@@ -21,7 +17,7 @@ import * as outputs from "./types/output";
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const exampleAdvancedCluster = new mongodbatlas.AdvancedCluster("example", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "cluster-test",
  *     clusterType: "REPLICASET",
@@ -37,9 +33,73 @@ import * as outputs from "./types/output";
  *         }],
  *     }],
  * });
- * const example = mongodbatlas.getAdvancedClustersOutput({
- *     projectId: exampleAdvancedCluster.projectId,
+ * const _this = mongodbatlas.getAdvancedClustersOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ * });
+ * ```
+ *
+ * ## Example using effective fields with auto-scaling
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as mongodbatlas from "@pulumi/mongodbatlas";
+ *
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
+ *     projectId: "<YOUR-PROJECT-ID>",
+ *     name: "auto-scale-cluster-1",
+ *     clusterType: "REPLICASET",
+ *     useEffectiveFields: true,
+ *     replicationSpecs: [{
+ *         regionConfigs: [{
+ *             electableSpecs: {
+ *                 instanceSize: "M10",
+ *                 nodeCount: 3,
+ *             },
+ *             autoScaling: {
+ *                 computeEnabled: true,
+ *                 computeScaleDownEnabled: true,
+ *                 computeMinInstanceSize: "M10",
+ *                 computeMaxInstanceSize: "M30",
+ *             },
+ *             providerName: "AWS",
+ *             priority: 7,
+ *             regionName: "US_EAST_1",
+ *         }],
+ *     }],
+ * });
+ * const this2 = new mongodbatlas.AdvancedCluster("this_2", {
+ *     projectId: "<YOUR-PROJECT-ID>",
+ *     name: "auto-scale-cluster-2",
+ *     clusterType: "REPLICASET",
+ *     useEffectiveFields: true,
+ *     replicationSpecs: [{
+ *         regionConfigs: [{
+ *             electableSpecs: {
+ *                 instanceSize: "M20",
+ *                 nodeCount: 3,
+ *             },
+ *             autoScaling: {
+ *                 computeEnabled: true,
+ *                 computeScaleDownEnabled: true,
+ *                 computeMinInstanceSize: "M20",
+ *                 computeMaxInstanceSize: "M40",
+ *             },
+ *             providerName: "AWS",
+ *             priority: 7,
+ *             regionName: "US_WEST_2",
+ *         }],
+ *     }],
+ * });
+ * // Read effective values for all clusters in the project
+ * const _this = mongodbatlas.getAdvancedClusters({
+ *     projectId: "<YOUR-PROJECT-ID>",
+ *     useEffectiveFields: true,
  * });
+ * export const allClusterNamesAndSizes = _this.then(_this => .map(cluster => ({
+ *     name: cluster.name,
+ *     configuredSize: cluster.replicationSpecs?.[0]?.regionConfigs?.[0]?.electableSpecs?.instanceSize,
+ *     actualSize: cluster.replicationSpecs?.[0]?.regionConfigs?.[0]?.effectiveElectableSpecs?.instanceSize,
+ * })));
  * ```
  *
  * ## Example using latest sharding configurations with independent shard scaling in the cluster
@@ -48,7 +108,7 @@ import * as outputs from "./types/output";
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const example = new mongodbatlas.AdvancedCluster("example", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "cluster-test",
  *     backupEnabled: false,
@@ -80,10 +140,9 @@ import * as outputs from "./types/output";
  *         },
  *     ],
  * });
- * const example_asym = mongodbatlas.getAdvancedClusterOutput({
- *     projectId: example.projectId,
- *     name: example.name,
- *     useReplicationSpecPerShard: true,
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
  * });
  * ```
  *
@@ -93,7 +152,7 @@ import * as outputs from "./types/output";
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const example_flex = new mongodbatlas.AdvancedCluster("example-flex", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "flex-cluster",
  *     clusterType: "REPLICASET",
@@ -106,8 +165,8 @@ import * as outputs from "./types/output";
  *         }],
  *     }],
  * });
- * const example = mongodbatlas.getAdvancedClustersOutput({
- *     projectId: example_flex.projectId,
+ * const _this = mongodbatlas.getAdvancedClustersOutput({
+ *     projectId: thisAdvancedCluster.projectId,
  * });
  * ```
  */
@@ -121,9 +180,9 @@ export interface GetAdvancedClustersArgs {
      */
     projectId: string;
     /**
-     * Set this field to true to allow the data source to use the latest schema representing each shard with an individual `replicationSpecs` object. This enables representing clusters with independent shard scaling. **Note:** If not set to true, this data source return all clusters except clusters with asymmetric shards.
+     * Controls how hardware specification fields are returned in the response. When set to true, the non-effective specs (`electableSpecs`, `readOnlySpecs`, `analyticsSpecs`) fields return the hardware specifications that the client provided. When set to false (default), the non-effective specs fields show the **current** hardware specifications. Cluster auto-scaling is the primary cause for differences between initial and current hardware specifications. This attribute applies to dedicated clusters, not to tenant or flex clusters. **Note:** Effective specs (`effectiveElectableSpecs`, `effectiveReadOnlySpecs`, `effectiveAnalyticsSpecs`) are always returned for dedicated clusters regardless of the flag value and always report the **current** hardware specifications. See the resource documentation for Auto-Scaling with Effective Fields for more details.
      */
-    useReplicationSpecPerShard?: boolean;
+    useEffectiveFields?: boolean;
 }
 /**
  * A collection of values returned by getAdvancedClusters.
@@ -138,15 +197,11 @@ export interface GetAdvancedClustersResult {
      * A list where each represents a Cluster. See below for more details.
      */
     readonly results: outputs.GetAdvancedClustersResult[];
-    readonly useReplicationSpecPerShard?: boolean;
+    readonly useEffectiveFields?: boolean;
 }
 /**
- * ## # Data Source: mongodbatlas.getAdvancedClusters
- *
  * `mongodbatlas.getAdvancedClusters` returns all Advanced Clusters for a project_id.
  *
- * This page describes the current version of `mongodbatlas.getAdvancedClusters`, the page for the **Preview for MongoDB Atlas Provider 2.0.0** can be found here.
- *
  * > **NOTE:** Groups and projects are synonymous terms. You may find groupId in the official documentation.
  *
  * > **IMPORTANT:**
@@ -161,7 +216,7 @@ export interface GetAdvancedClustersResult {
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const exampleAdvancedCluster = new mongodbatlas.AdvancedCluster("example", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "cluster-test",
  *     clusterType: "REPLICASET",
@@ -177,9 +232,73 @@ export interface GetAdvancedClustersResult {
  *         }],
  *     }],
  * });
- * const example = mongodbatlas.getAdvancedClustersOutput({
- *     projectId: exampleAdvancedCluster.projectId,
+ * const _this = mongodbatlas.getAdvancedClustersOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ * });
+ * ```
+ *
+ * ## Example using effective fields with auto-scaling
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as mongodbatlas from "@pulumi/mongodbatlas";
+ *
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
+ *     projectId: "<YOUR-PROJECT-ID>",
+ *     name: "auto-scale-cluster-1",
+ *     clusterType: "REPLICASET",
+ *     useEffectiveFields: true,
+ *     replicationSpecs: [{
+ *         regionConfigs: [{
+ *             electableSpecs: {
+ *                 instanceSize: "M10",
+ *                 nodeCount: 3,
+ *             },
+ *             autoScaling: {
+ *                 computeEnabled: true,
+ *                 computeScaleDownEnabled: true,
+ *                 computeMinInstanceSize: "M10",
+ *                 computeMaxInstanceSize: "M30",
+ *             },
+ *             providerName: "AWS",
+ *             priority: 7,
+ *             regionName: "US_EAST_1",
+ *         }],
+ *     }],
+ * });
+ * const this2 = new mongodbatlas.AdvancedCluster("this_2", {
+ *     projectId: "<YOUR-PROJECT-ID>",
+ *     name: "auto-scale-cluster-2",
+ *     clusterType: "REPLICASET",
+ *     useEffectiveFields: true,
+ *     replicationSpecs: [{
+ *         regionConfigs: [{
+ *             electableSpecs: {
+ *                 instanceSize: "M20",
+ *                 nodeCount: 3,
+ *             },
+ *             autoScaling: {
+ *                 computeEnabled: true,
+ *                 computeScaleDownEnabled: true,
+ *                 computeMinInstanceSize: "M20",
+ *                 computeMaxInstanceSize: "M40",
+ *             },
+ *             providerName: "AWS",
+ *             priority: 7,
+ *             regionName: "US_WEST_2",
+ *         }],
+ *     }],
+ * });
+ * // Read effective values for all clusters in the project
+ * const _this = mongodbatlas.getAdvancedClusters({
+ *     projectId: "<YOUR-PROJECT-ID>",
+ *     useEffectiveFields: true,
  * });
+ * export const allClusterNamesAndSizes = _this.then(_this => .map(cluster => ({
+ *     name: cluster.name,
+ *     configuredSize: cluster.replicationSpecs?.[0]?.regionConfigs?.[0]?.electableSpecs?.instanceSize,
+ *     actualSize: cluster.replicationSpecs?.[0]?.regionConfigs?.[0]?.effectiveElectableSpecs?.instanceSize,
+ * })));
  * ```
  *
  * ## Example using latest sharding configurations with independent shard scaling in the cluster
@@ -188,7 +307,7 @@ export interface GetAdvancedClustersResult {
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const example = new mongodbatlas.AdvancedCluster("example", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "cluster-test",
  *     backupEnabled: false,
@@ -220,10 +339,9 @@ export interface GetAdvancedClustersResult {
  *         },
  *     ],
  * });
- * const example_asym = mongodbatlas.getAdvancedClusterOutput({
- *     projectId: example.projectId,
- *     name: example.name,
- *     useReplicationSpecPerShard: true,
+ * const _this = mongodbatlas.getAdvancedClusterOutput({
+ *     projectId: thisAdvancedCluster.projectId,
+ *     name: thisAdvancedCluster.name,
  * });
  * ```
  *
@@ -233,7 +351,7 @@ export interface GetAdvancedClustersResult {
  * import * as pulumi from "@pulumi/pulumi";
  * import * as mongodbatlas from "@pulumi/mongodbatlas";
  *
- * const example_flex = new mongodbatlas.AdvancedCluster("example-flex", {
+ * const thisAdvancedCluster = new mongodbatlas.AdvancedCluster("this", {
  *     projectId: "<YOUR-PROJECT-ID>",
  *     name: "flex-cluster",
  *     clusterType: "REPLICASET",
@@ -246,8 +364,8 @@ export interface GetAdvancedClustersResult {
  *         }],
  *     }],
  * });
- * const example = mongodbatlas.getAdvancedClustersOutput({
- *     projectId: example_flex.projectId,
+ * const _this = mongodbatlas.getAdvancedClustersOutput({
+ *     projectId: thisAdvancedCluster.projectId,
  * });
  * ```
  */
@@ -261,7 +379,7 @@ export interface GetAdvancedClustersOutputArgs {
      */
     projectId: pulumi.Input<string>;
     /**
-     * Set this field to true to allow the data source to use the latest schema representing each shard with an individual `replicationSpecs` object. This enables representing clusters with independent shard scaling. **Note:** If not set to true, this data source return all clusters except clusters with asymmetric shards.
+     * Controls how hardware specification fields are returned in the response. When set to true, the non-effective specs (`electableSpecs`, `readOnlySpecs`, `analyticsSpecs`) fields return the hardware specifications that the client provided. When set to false (default), the non-effective specs fields show the **current** hardware specifications. Cluster auto-scaling is the primary cause for differences between initial and current hardware specifications. This attribute applies to dedicated clusters, not to tenant or flex clusters. **Note:** Effective specs (`effectiveElectableSpecs`, `effectiveReadOnlySpecs`, `effectiveAnalyticsSpecs`) are always returned for dedicated clusters regardless of the flag value and always report the **current** hardware specifications. See the resource documentation for Auto-Scaling with Effective Fields for more details.
      */
-    useReplicationSpecPerShard?: pulumi.Input<boolean>;
+    useEffectiveFields?: pulumi.Input<boolean>;
 }