diff --git a/specification/storage/data-plane/Microsoft.FileStorage/stable/2025-01-05/file.json b/specification/storage/data-plane/Microsoft.FileStorage/stable/2025-01-05/file.json
index fddbcfb61b94..904e160827cb 100644
--- a/specification/storage/data-plane/Microsoft.FileStorage/stable/2025-01-05/file.json
+++ b/specification/storage/data-plane/Microsoft.FileStorage/stable/2025-01-05/file.json
@@ -328,19 +328,25 @@
                 "x-ms-client-name": "ShareProvisionedIops",
                 "type": "integer",
                 "format": "int64",
-                "description": "The provisioned IOPS of the share. If this is not specified, compute the recommended IOPS of the share using the formula for a share in this media tier (SSD/HDD as appropriate)."
+                "description": "The provisioned IOPS of the share."
               },
               "x-ms-share-provisioned-bandwidth-mibps": {
                 "x-ms-client-name": "ShareProvisionedBandwidthMibps",
                 "type": "integer",
                 "format": "int64",
-                "description": "The provisioned throughput of the share. If this is not specified, compute the recommended throughput of the share using the formula for a share in this media tier (SSD/HDD as appropriate)."
+                "description": "The provisioned throughput of the share."
               },
               "x-ms-share-included-burst-iops": {
                 "x-ms-client-name": "ShareIncludedBurstIops",
                 "type": "integer",
                 "format": "int64",
-                "description": "ShareIncludedBurstIops"
+                "description": "Returns the calculated burst IOPS of the share."
+              },
+              "x-ms-share-max-burst-credits-for-iops": {
+                "x-ms-client-name": "MaxBurstCreditsForIops",
+                "description": "Returned the calculated maximum burst credits.",
+                "type": "integer",
+                "format": "int64"
               }
             }
           },
@@ -444,7 +450,7 @@
               "x-ms-share-provisioned-bandwidth-mibps": {
                 "x-ms-client-name": "ProvisionedBandwidthMibps",
                 "type": "integer",
-                "description": "Returns the current share provisioned bandwidth in megabits per second."
+                "description": "Returns the current share provisioned bandwidth in mebibytes per second."
               },
               "x-ms-lease-duration": {
                 "x-ms-client-name": "LeaseDuration",
@@ -559,13 +565,13 @@
               },
               "x-ms-share-next-allowed-provisioned-iops-downgrade-time": {
                 "x-ms-client-name": "NextAllowedProvisionedIopsDowngradeTime",
-                "description": "Return timestamp for provisioned IOPS following existing rules for provisioned storage GiB.",
+                "description": "Returns the current share next allowed provisioned iops downgrade time.",
                 "type": "string",
                 "format": "date-time-rfc1123"
               },
               "x-ms-share-next-allowed-provisioned-bandwidth-downgrade-time": {
                 "x-ms-client-name": "NextAllowedProvisionedBandwidthDowngradeTime",
-                "description": "Return timestamp for provisioned throughput following existing rules for provisioned storage GiB.",
+                "description": "Returns the current share next allowed provisioned bandwidth downgrade time.",
                 "type": "string",
                 "format": "date-time-rfc1123"
               }
@@ -630,15 +636,15 @@
                 "format": "date-time-rfc1123",
                 "description": "A UTC date/time value generated by the service that indicates the time at which the response was initiated."
               },
-              "x-ms-share-usage-bytes": {
+              "x-ms-file-share-usage-bytes": {
                 "type": "integer",
                 "format": "int64",
-                "description": "The \"live share\" portion of the data that the customer will be billed for in the soft-deleted capacity (logical storage size)."
+                "description": "Returned only for provisioned v2 file shares. Returns an approximate used storage size of the share, in bytes."
               },
-              "x-ms-share-snapshot-usage-bytes": {
+              "x-ms-file-share-snapshot-usage-bytes": {
                 "type": "integer",
                 "format": "int64",
-                "description": "The snapshot share portion of the data that the customer will be billed for in the soft-deleted capacity (this is the delta, or \"physical storage size\")."
+                "description": "Returned only for provisioned v2 file shares. Returns an approximate used snapshot storage size of the share, in bytes."
               }
             }
           },
@@ -1638,7 +1644,7 @@
                 "x-ms-client-name": "ProvisionedBandwidthMibps",
                 "type": "integer",
                 "format": "int64",
-                "description": "Returns the current share provisioned bandwidth in megabits per second."
+                "description": "Returns the current share provisioned bandwidth in mebibytes per second."
               },
               "x-ms-share-included-burst-iops": {
                 "x-ms-client-name": "IncludedBurstIops",
@@ -1660,13 +1666,13 @@
               },
               "x-ms-share-next-allowed-provisioned-iops-downgrade-time": {
                 "x-ms-client-name": "NextAllowedProvisionedIopsDowngradeTime",
-                "description": "Return timestamp for provisioned IOPS following existing rules for provisioned storage GiB.",
+                "description": "Returns the current share next allowed provisioned iops downgrade time.",
                 "type": "string",
                 "format": "date-time-rfc1123"
               },
               "x-ms-share-next-allowed-provisioned-bandwidth-downgrade-time": {
                 "x-ms-client-name": "NextAllowedProvisionedBandwidthDowngradeTime",
-                "description": "Return timestamp for provisioned throughput following existing rules for provisioned storage GiB.",
+                "description": "Returns the current share next allowed provisioned bandwidth downgrade time.",
                 "type": "string",
                 "format": "date-time-rfc1123"
               }
@@ -2137,7 +2143,7 @@
                 "x-ms-client-name": "ProvisionedBandwidthMibps",
                 "type": "integer",
                 "format": "int64",
-                "description": "Returns the current share provisioned bandwidth in megabits per second."
+                "description": "Returns the current share provisioned bandwidth in mebibytes per second."
               },
               "x-ms-share-included-burst-iops": {
                 "x-ms-client-name": "IncludedBurstIops",
@@ -7703,7 +7709,7 @@
       "name": "x-ms-share-provisioned-iops",
       "x-ms-client-name": "shareProvisionedIops",
       "in": "header",
-      "description": "Optional. The provisioned IOPS of the share. If this is not specified, compute the recommended IOPS of the share using the formula for a share in this media tier (SSD/HDD as appropriate). The provisioned IOPS of the share is always explicitly stored on the share object, even if the recommendation formula is used.",
+      "description": "Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this is not specified, the provisioned IOPS is set to value calculated based on recommendation formula.",
       "required": false,
       "type": "integer",
       "format": "int64",
@@ -7713,7 +7719,7 @@
       "name": "x-ms-share-provisioned-bandwidth-mibps",
       "x-ms-client-name": "shareProvisionedBandwidthMibps",
       "in": "header",
-      "description": "Optional. The provisioned throughput of the share. If this is not specified, compute the recommended throughput of the share using the formula for a share in this media tier (SSD/HDD as appropriate).",
+      "description": "Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula.",
       "required": false,
       "type": "integer",
       "format": "int64",