<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 08:07:12 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[DOCS-13211] Terraform documentation for Azure unclear - `disk_size_gb` cannot be used with Azure clusters - Harmonize with API documentation</title>
                <link>https://jira.mongodb.org/browse/DOCS-13211</link>
                <project id="10380" key="DOCS">Documentation</project>
                    <description>&lt;h2&gt;&lt;a name=&quot;Description&quot;&gt;&lt;/a&gt;Description&lt;/h2&gt;
&lt;p&gt;Customers have been raising the issue, that the documentation for Terraform is unclear as they were running into errors when using the Terraform Provider.&lt;/p&gt;

&lt;p&gt;Error: `disk_size_gb` cannot be used with Azure cluster&lt;/p&gt;

&lt;p&gt;The reason is that Azure only provides the disk types.&lt;/p&gt;

&lt;p&gt;This is more clearly defined in the API documentation - suggestion is to harmonise the two documentations and also transfer the table from the API documentation also to the Terraform documentation to make this clear:&lt;br/&gt;
&lt;a href=&quot;https://docs.atlas.mongodb.com/reference/api/clusters-create-one/&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://docs.atlas.mongodb.com/reference/api/clusters-create-one/&lt;/a&gt;&lt;/p&gt;
&lt;div class=&apos;table-wrap&apos;&gt;
&lt;table class=&apos;confluenceTable&apos;&gt;&lt;tbody&gt;
&lt;tr&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;&lt;tt&gt;providerSettings&lt;/tt&gt;&lt;br/&gt;
&lt;tt&gt;.diskTypeName&lt;/tt&gt;&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;string&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;Azure Required&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;Azure disk type of the server&#8217;s root volume. If omitted, Atlas uses the default disk type for the selected&#160;&lt;tt&gt;providerSettings.instanceSizeName&lt;/tt&gt;.&lt;br/&gt;
The following table lists the possible values for this field, and their corresponding storage size.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;th class=&apos;confluenceTh&apos;&gt;&lt;tt&gt;diskTypeName&lt;/tt&gt;&lt;/th&gt;
&lt;th class=&apos;confluenceTh&apos;&gt;Storage Size&lt;/th&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;&lt;tt&gt;P4&lt;/tt&gt;&#160;&lt;sup&gt;1&lt;/sup&gt;&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;32GB&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;&lt;tt&gt;P6&lt;/tt&gt;&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;64GB&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;&lt;tt&gt;P10&lt;/tt&gt;&#160;&lt;sup&gt;2&lt;/sup&gt;&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;128GB&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;&lt;tt&gt;P20&lt;/tt&gt;&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;512GB&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;&lt;tt&gt;P30&lt;/tt&gt;&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;1024GB&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;&lt;tt&gt;P40&lt;/tt&gt;&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;2048GB&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;&lt;tt&gt;P50&lt;/tt&gt;&lt;/td&gt;
&lt;td class=&apos;confluenceTd&apos;&gt;4095GB&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;/div&gt;

&lt;p&gt;&lt;sup&gt;1&lt;/sup&gt;&#160;Default for&#160;&lt;tt&gt;M20&lt;/tt&gt;&#160;and&#160;&lt;tt&gt;M30&lt;/tt&gt;&#160;Azure clusters&lt;br/&gt;
&lt;sup&gt;2&lt;/sup&gt;&#160;Default for&#160;&lt;tt&gt;M40+&lt;/tt&gt;&#160;Azure clusters|&lt;/p&gt;

&lt;h2&gt;&lt;a name=&quot;Scopeofchanges&quot;&gt;&lt;/a&gt;Scope of changes&lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;ImpacttoOtherDocs&quot;&gt;&lt;/a&gt;Impact to Other Docs&lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;MVP%28WorkandDate%29&quot;&gt;&lt;/a&gt;MVP (Work and Date)&lt;/h2&gt;

&lt;h2&gt;&lt;a name=&quot;Resources%28ScopeorDesignDocs%2CInvision%2Cetc.%29&quot;&gt;&lt;/a&gt;Resources (Scope or Design Docs, Invision, etc.)&lt;/h2&gt;
</description>
                <environment>MongoDB Atlas on Azure - Terraform</environment>
        <key id="993723">DOCS-13211</key>
            <summary>Terraform documentation for Azure unclear - `disk_size_gb` cannot be used with Azure clusters - Harmonize with API documentation</summary>
                <type id="4" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14710&amp;avatarType=issuetype">Improvement</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</priority>
                        <status id="6" iconUrl="https://jira.mongodb.org/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="success"/>
                                    <resolution id="13201">Fixed</resolution>
                                        <assignee username="melissa.plunkett@mongodb.com">Melissa Plunkett</assignee>
                                    <reporter username="julian.storz@mongodb.com">Julian Storz</reporter>
                        <labels>
                            <label>api</label>
                            <label>terraform</label>
                    </labels>
                <created>Fri, 8 Nov 2019 09:30:09 +0000</created>
                <updated>Sun, 29 Oct 2023 13:55:44 +0000</updated>
                            <resolved>Mon, 11 Nov 2019 23:05:55 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>2</watches>
                                                                                                                <comments>
                            <comment id="2537097" author="julian.storz" created="Tue, 12 Nov 2019 18:21:48 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=melissa.plunkett&quot; class=&quot;user-hover&quot; rel=&quot;melissa.plunkett&quot;&gt;melissa.plunkett&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Thank You&lt;/p&gt;</comment>
                            <comment id="2530348" author="melissa.plunkett" created="Mon, 11 Nov 2019 23:02:18 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=julian.storz&quot; class=&quot;user-hover&quot; rel=&quot;julian.storz&quot;&gt;julian.storz&lt;/a&gt; - PR to adjust this &lt;a href=&quot;https://github.com/terraform-providers/terraform-provider-mongodbatlas/pull/66&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/terraform-providers/terraform-provider-mongodbatlas/pull/66&lt;/a&gt;&lt;/p&gt;
</comment>
                            <comment id="2527811" author="julian.storz" created="Mon, 11 Nov 2019 12:59:14 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=melissa.plunkett&quot; class=&quot;user-hover&quot; rel=&quot;melissa.plunkett&quot;&gt;melissa.plunkett&lt;/a&gt; - Yes this should be sufficient.&lt;/p&gt;

&lt;p&gt;I think the core reason for the confusion was, that it was not clear, that not all the flags are available for all cloud providers.&lt;br/&gt;
The key part is that it is clear, how the single components of the underlying infrastructure can be managed via Terraform.&lt;/p&gt;

&lt;p&gt;In this case, that the disk allocation in Azure is defined using the&#160;&lt;em&gt;diskTypeName&lt;/em&gt; rather than&#160;&lt;em&gt;disk_size_gb.&lt;/em&gt;&lt;br/&gt;
Maybe just also flag this in the Azrue example - as seeing &quot;P6&quot; is not intuitive to me that this means: 64 GB.&lt;/p&gt;

&lt;p&gt;If the point you mentioned can also be noted - this would be very helpful.&lt;/p&gt;

&lt;p&gt;Thank you for your help!&lt;/p&gt;</comment>
                            <comment id="2526286" author="melissa.plunkett" created="Fri, 8 Nov 2019 22:13:57 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=julian.storz&quot; class=&quot;user-hover&quot; rel=&quot;julian.storz&quot;&gt;julian.storz&lt;/a&gt; - question for you, the Azure example does not have disk_size_gb: &lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;https://www.terraform.io/docs/providers/mongodbatlas/r/cluster.html#example-azure-cluster-&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://www.terraform.io/docs/providers/mongodbatlas/r/cluster.html#example-azure-cluster-&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Example Azure cluster.&lt;/p&gt;

&lt;p&gt;resource &quot;mongodbatlas_cluster&quot; &quot;test&quot; &lt;/p&gt;
{
  project_id   = &quot;&amp;lt;YOUR-PROJECT-ID&amp;gt;&quot;
  name         = &quot;test&quot;
  num_shards   = 1

  replication_factor           = 3
  backup_enabled               = true
  auto_scaling_disk_gb_enabled = true
  mongo_db_major_version       = &quot;4.0&quot;

  //Provider Settings &quot;block&quot;
  provider_name               = &quot;AZURE&quot;  
  provider_disk_type_name     = &quot;P6&quot;
  provider_instance_size_name = &quot;M30&quot;
  provider_region_name        = &quot;US_EAST_2&quot;
}

&lt;p&gt;So is it just that we should update the attribute disk_size_db that it is only for GCP/AWS?   Just want to make sure I know where the confusion comes from.  &lt;/p&gt;
</comment>
                            <comment id="2525585" author="melissa.plunkett" created="Fri, 8 Nov 2019 17:51:51 +0000"  >&lt;p&gt;&lt;a href=&quot;https://jira.mongodb.org/secure/ViewProfile.jspa?name=julian.storz&quot; class=&quot;user-hover&quot; rel=&quot;julian.storz&quot;&gt;julian.storz&lt;/a&gt; thank you for submitting this.   The documentation for Terraform was written by our contractor from our API docs but simplified as per the Terraform standard doc style (one can look at the underlying API docs which are linked to in many places).    Hence it isn&apos;t our docs team maintaining this.  I will work on a some improvements to make this information more clear but it is unlikely we will copy too much of our underlying docs to the Terraform hosted docs (that means updating two very seperate places on each change).&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                <customfield id="customfield_10050" key="com.atlassian.jira.toolkit:comments">
                        <customfieldname># Replies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>5.0</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_13552" key="com.go2group.jira.plugin.crm:crm_generic_field">
                        <customfieldname>Case</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[[5006R00001nrX6GQAU]]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_10055" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>Date of 1st Reply</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Fri, 8 Nov 2019 17:51:51 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10052" key="com.atlassian.jira.toolkit:dayslastcommented">
                        <customfieldname>Days since reply</customfieldname>
                        <customfieldvalues>
                                        4 years, 13 weeks, 1 day ago
    
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_18254" key="com.onresolve.jira.groovy.groovyrunner:scripted-field">
                        <customfieldname>Dependencies</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue><![CDATA[]]></customfieldvalue>


                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                <customfield id="customfield_10040" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
                        <customfieldname>Estimate</customfieldname>
                        <customfieldvalues>
                                <customfieldvalue key="10042"><![CDATA[Small]]></customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10057" key="com.atlassian.jira.toolkit:lastusercommented">
                        <customfieldname>Last comment by Customer</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>true</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10056" key="com.atlassian.jira.toolkit:lastupdaterorcommenter">
                        <customfieldname>Last commenter</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>luke.bonanomi@mongodb.com</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_11151" key="com.atlassian.jira.toolkit:LastCommentDate">
                        <customfieldname>Last public comment date</customfieldname>
                        <customfieldvalues>
                            4 years, 13 weeks, 1 day ago
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                            <customfield id="customfield_10051" key="com.atlassian.jira.toolkit:participants">
                        <customfieldname>Participants</customfieldname>
                        <customfieldvalues>
                                        <customfieldvalue>julian.storz@mongodb.com</customfieldvalue>
            <customfieldvalue>melissa.plunkett@mongodb.com</customfieldvalue>
    
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                        <customfield id="customfield_14254" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Product Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hw18ef:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hvpj2v:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10053" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>Time In Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_14350" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>serverRank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>1|hw0unr:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                </customfields>
    </item>
</channel>
</rss>