RDoc-3881 Document Azure Premium SSD v2 support in RavenDB Cloud

cloud/cloud-scaling.mdx

@@ -137,13 +137,75 @@ running on a Disk of size for which a given *Performance Tier* is the
 default one.
 </Admonition>
 
-### Data disks
+#### Azure Premium SSD v2 {#azure-premium-ssd-v2}
+
+**Premium SSD v2** is an Azure disk type available alongside **Standard** and **Premium**. It offers
+**IOPS** and **Throughput** that can be configured independently of the disk size, giving you finer
+control over storage performance and cost.
+
+!["Figure - Azure Premium SSD v2 storage edit form with editable IOPS and Throughput"](./assets/portal-product-details-edit-storage-premium-ssd-v2.png)
+
+**Availability and constraints:**
+
+* Available **only as a data disk** — it cannot be used as the OS disk. This means **Premium SSD v2**
+  is offered only for products that use the **Single Data Disk** layout (see [Data disks](#data-disks)).
+  Products with the *Root Only* disk layout use **Premium SSD v1**; **Premium SSD v2** is not available
+  for them.
+* Not available for **PN\*** (ephemeral) instance types of the *Performance Tier*.
+* Not available for products on a **yearly** payment plan.
+* Available only in **Azure regions that support Premium SSD v2**. The portal automatically detects
+  the region and shows the option only when it qualifies.
+* Unlike **Premium**, **Premium SSD v2** does **not** offer an *Azure Performance Tier* customization.
+* **IOPS** and **Throughput** are configurable independently of the disk size. The available
+  **Throughput** range depends on the configured **IOPS** value.
+
+<Admonition type="warning" title="One-way storage type change">
+Switching to **Premium SSD v2** is a **one-way operation**:
+
+* **Downgrade from Premium SSD v2 to Standard** is **not possible** when using the *Single Data Disk*
+  layout.
+* **Downgrade from Premium SSD v2 to Premium (v1)** is **not possible**.
+
+Plan the change carefully — once a product is on **Premium SSD v2**, it cannot be moved back.
+</Admonition>
+
+There are two ways to start using **Premium SSD v2**:
+
+1. **Migrate the storage to a Data Disk** — when the product's region supports **Premium SSD v2**,
+   the new data disk is automatically created as **Premium SSD v2**. The migration modal indicates
+   when this is the case. See [Data disks](#data-disks).
+2. **Upgrade an existing Premium Single Data disk to Premium SSD v2** — if your product already
+   runs on a **Premium** *Single Data Disk* and is eligible, the **Upgrade to Premium V2** button
+   is shown in the *Storage* section of the product page. See
+   [Managing an Existing Product](../cloud/portal/cloud-portal-products-tab.mdx#change-instance-type-and-storage)
+   in the portal documentation.
+
+!["Figure - Upgrade to Azure Premium SSD v2 modal with IOPS and Throughput fields"](./assets/portal-product-details-upgrade-to-premium-v2-modal.png)
+
+The upgrade is performed **node by node**. Each node being migrated is briefly unavailable, and the
+full operation may take **multiple hours** to complete. The migration uses your current **IOPS** and
+**Throughput** values; you can adjust them afterwards from the storage settings.
+
+<Admonition type="info" title="Pricing">
+For **Premium SSD v2**, **IOPS** and **Throughput** are billed separately from disk capacity.
+For up-to-date rates, see the [Pricing page](https://cloud.ravendb.net/pricing).
+</Admonition>
+
+### Data disks {#data-disks}
 
 **Data Disks** are dedicated storage volumes used exclusively for RavenDB data. They are available for instances running in the *Production Tier*. These disks are entirely separate from the operating system disk, which remains isolated to ensure system stability and optimal performance.
 
 The use of a data disk is mandatory for deployments requiring more than 1TB of storage.
 
 **Data Disk** can be selected during instance creation or migrated to on already existing instances.
+
+!["Figure - Migrate to data disk modal showing Premium SSD v2 information"](./assets/portal-product-details-migrate-to-data-disk-premium-v2.png)
+
+<Admonition type="info" title="Azure: data disk created as Premium SSD v2">
+On **Azure**, when the product's region supports **Premium SSD v2**, migrating to a Data Disk
+automatically creates the new data disk as **Premium SSD v2**. The migration modal indicates this.
+See [Azure Premium SSD v2](#azure-premium-ssd-v2) for capabilities and constraints.
+</Admonition>
 ### GCP Disks
 
 <Admonition type="info" title="">

cloud/portal/cloud-portal-products-tab.mdx

@@ -165,7 +165,14 @@ You can view your configuration and change your product's instance type and stor
 
 !["Figure 17 - Manage Product: Storage"](./assets/portal-product-details-storage.png)
 
-  More details can be found [here](../cloud-scaling.mdx#scaling---change-storage).
+  When eligible, the *Storage* section also shows an **Upgrade to Premium V2** button to upgrade
+  the disk to **Azure Premium SSD v2**.
+
+!["Figure 18 - Storage section with Upgrade to Premium V2 button"](./assets/portal-product-details-storage-upgrade-to-premium-v2.png)
+
+  More details can be found [here](../cloud-scaling.mdx#scaling---change-storage). For
+  **Azure Premium SSD v2** — eligibility, constraints, and behavior of the upgrade — see
+  [Azure Premium SSD v2](../cloud-scaling.mdx#azure-premium-ssd-v2).
 
 ### Instance Access
 
@@ -176,7 +183,7 @@ You can view your configuration and change your product's instance type and stor
 Use the security tab to download your [certificate](../../cloud/cloud-security.mdx) or determine which addresses are 
 allowed to connect your database instance.  
 
-!["Figure 18 - Manage Product: Manage access"](./assets/portal-product-details-manage-access.png)
+!["Figure 19 - Manage Product: Manage access"](./assets/portal-product-details-manage-access.png)
 
 * **Download Certificate** Click this button to download the **Initial Client Certificate**.
   This is an **operator-level** certificate used to perform cluster-wide operations (like creating/deleting databases) and for your first login to RavenDB Studio.
@@ -202,12 +209,12 @@ allowed to connect your database instance.
 * **See audit logs**
   Click this button to view audit logs. A popup will show where you have to select a year and month.
   You can download audit logs from there.
-  !["Figure 19 - See audit logs"](./assets/portal-product-details-audit-logs.png)
+  !["Figure 20 - See audit logs"](./assets/portal-product-details-audit-logs.png)
 
 * **Edit**  
   Click this button to edit your product's list of Allowed IPs.
 
-  !["Figure 20 - Manage Product: Edit IPs"](./assets/portal-product-details-allowed-ips.png)
+  !["Figure 21 - Manage Product: Edit IPs"](./assets/portal-product-details-allowed-ips.png)
 
   <Admonition type="info" title="We recommend fortifying your security by allowing access only to specific IPs" id="we-recommend-fortifying-your-security-by-allowing-access-only-to-specific-ips" href="#we-recommend-fortifying-your-security-by-allowing-access-only-to-specific-ips">
   You can increase your system's security further using this in-depth security measure and restrict access to
@@ -223,34 +230,34 @@ You can view features available for your product, enable, disable and configure
 After enabling features some of them must be configured to work properly.
 </Admonition>
 
-!["Figure 21 - Manage Features: Configure or disable features"](./assets/portal-product-features-enabled.png)
+!["Figure 22 - Manage Features: Configure or disable features"](./assets/portal-product-features-enabled.png)
 
 Available features are described on [Product Features](../cloud-features.mdx) page.
 
 ### Nodes: Additional product nodes
 
 You can expand your cluster by adding *more product nodes* to your cluster. This helps improve *High Availability* and *task/load balancing*.
 
-!["Figure 22 - Nodes: Manage additional nodes"](./assets/portal-product-nodes-additional-nodes.png)
+!["Figure 23 - Nodes: Manage additional nodes"](./assets/portal-product-nodes-additional-nodes.png)
 
 More details can be found [here](../cloud-scaling.mdx#additional-product-nodes---general).
 
 ### Maintenance and Danger Zones
 You can restart your product nodes, deploy additional tools and terminate your product here.
 
-!["Figure 23 - Manage Product: Maintenance and Termination"](./assets/portal-product-details-maintenance-and-termination.png)
+!["Figure 24 - Manage Product: Maintenance and Termination"](./assets/portal-product-details-maintenance-and-termination.png)
 * **Maintenance Zone**  
   Use this tab to restart selected node and deploy RavenDB tools. For *Serverless* products, you can switch to regular deployment.
 
 <Admonition type="danger" title="">
 Changing your product deployment type is **irreversible**.
 </Admonition>
 
-!["Figure 24 - Manage Product: Storage"](./assets/portal-product-details-maintenance-zone.png)
+!["Figure 25 - Manage Product: Storage"](./assets/portal-product-details-maintenance-zone.png)
 * **Danger Zone**  
   Use this tab's **Terminate** button to eliminate your cluster.
 
-!["Figure 25 - Manage Product: Terminate"](./assets/portal-product-details-terminate-product.png)
+!["Figure 26 - Manage Product: Terminate"](./assets/portal-product-details-terminate-product.png)
 
   <Admonition type="danger" title="">
   Terminating your instance is **irreversible**. Your data and cluster properties will be permanently lost.