Skip to content

Commit e1f2a4d

Browse files
authored
Merge pull request #813 from calvinhzy/storage-account-migration-bump-2024-01-01
{Storage} `az storage account migration`: Bump api-version to 2024-01-01 from 2023-01-01
2 parents adaaa35 + 61860dc commit e1f2a4d

File tree

6 files changed

+238
-0
lines changed
  • Commands/storage/account/migration
  • Resources/mgmt-plane
    • L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5zdG9yYWdlL3N0b3JhZ2VhY2NvdW50cy97fS9hY2NvdW50bWlncmF0aW9ucy97fQ==
    • L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5zdG9yYWdlL3N0b3JhZ2VhY2NvdW50cy97fS9zdGFydGFjY291bnRtaWdyYXRpb24=

6 files changed

+238
-0
lines changed

Commands/storage/account/migration/_show.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,14 @@ Get the status of the ongoing migration for the specified storage account.
1414
```bash
1515
storage account migration show --account-name "storage_account_name" -g "resource_group_name"
1616
```
17+
18+
### [2024-01-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5zdG9yYWdlL3N0b3JhZ2VhY2NvdW50cy97fS9hY2NvdW50bWlncmF0aW9ucy97fQ==/2024-01-01.xml) **Stable**
19+
20+
<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.storage/storageaccounts/{}/accountmigrations/{} 2024-01-01 -->
21+
22+
#### examples
23+
24+
- migration show
25+
```bash
26+
storage account migration show --account-name "storage_account_name" -g "resource_group_name"
27+
```

Commands/storage/account/migration/_start.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,14 @@ Account Migration request can be triggered for a storage account to change its r
1414
```bash
1515
storage account migration start --account-name "storage_account_name" -g "resource_group_name" --sku Standard_ZRS --name default --no-wait
1616
```
17+
18+
### [2024-01-01](/Resources/mgmt-plane/L3N1YnNjcmlwdGlvbnMve30vcmVzb3VyY2Vncm91cHMve30vcHJvdmlkZXJzL21pY3Jvc29mdC5zdG9yYWdlL3N0b3JhZ2VhY2NvdW50cy97fS9zdGFydGFjY291bnRtaWdyYXRpb24=/2024-01-01.xml) **Stable**
19+
20+
<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.storage/storageaccounts/{}/startaccountmigration 2024-01-01 -->
21+
22+
#### examples
23+
24+
- migration start
25+
```bash
26+
storage account migration start --account-name "storage_account_name" -g "resource_group_name" --sku Standard_ZRS --name default --no-wait
27+
```
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"plane": "mgmt-plane", "resources": [{"id": "/subscriptions/{}/resourcegroups/{}/providers/microsoft.storage/storageaccounts/{}/accountmigrations/{}", "version": "2024-01-01", "swagger": "mgmt-plane/storage/ResourceProviders/Microsoft.Storage/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9yZXNvdXJjZUdyb3Vwcy97cmVzb3VyY2VHcm91cE5hbWV9L3Byb3ZpZGVycy9NaWNyb3NvZnQuU3RvcmFnZS9zdG9yYWdlQWNjb3VudHMve2FjY291bnROYW1lfS9hY2NvdW50TWlncmF0aW9ucy97bWlncmF0aW9uTmFtZX0=/V/MjAyNC0wMS0wMQ=="}], "commandGroups": [{"name": "storage account migration", "commands": [{"name": "show", "version": "2024-01-01", "resources": [{"id": "/subscriptions/{}/resourcegroups/{}/providers/microsoft.storage/storageaccounts/{}/accountmigrations/{}", "version": "2024-01-01", "swagger": "mgmt-plane/storage/ResourceProviders/Microsoft.Storage/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9yZXNvdXJjZUdyb3Vwcy97cmVzb3VyY2VHcm91cE5hbWV9L3Byb3ZpZGVycy9NaWNyb3NvZnQuU3RvcmFnZS9zdG9yYWdlQWNjb3VudHMve2FjY291bnROYW1lfS9hY2NvdW50TWlncmF0aW9ucy97bWlncmF0aW9uTmFtZX0=/V/MjAyNC0wMS0wMQ=="}], "argGroups": [{"name": "", "args": [{"type": "string", "var": "$Path.accountName", "options": ["account-name"], "required": true, "idPart": "name", "help": {"short": "The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only."}, "format": {"pattern": "^[a-z0-9]+$", "maxLength": 24, "minLength": 3}}, {"type": "string", "var": "$Path.migrationName", "options": ["n", "name", "migration-name"], "required": true, "idPart": "child_name_1", "help": {"short": "The name of the Storage Account Migration. It should always be 'default'"}, "format": {"pattern": "^[a-z][a-z0-9]*$"}, "enum": {"items": [{"name": "default", "value": "default"}]}}, {"type": "ResourceGroupName", "var": "$Path.resourceGroupName", "options": ["g", "resource-group"], "required": true, "idPart": "resource_group"}, {"type": "SubscriptionId", "var": "$Path.subscriptionId", "options": ["subscription"], "required": true, "idPart": "subscription"}]}], "operations": [{"operationId": "StorageAccounts_GetCustomerInitiatedMigration", "http": {"path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/accountMigrations/{migrationName}", "request": {"method": "get", "path": {"params": [{"type": "string", "name": "accountName", "arg": "$Path.accountName", "required": true, "format": {"pattern": "^[a-z0-9]+$", "maxLength": 24, "minLength": 3}}, {"type": "string", "name": "migrationName", "arg": "$Path.migrationName", "required": true, "format": {"pattern": "^[a-z][a-z0-9]*$"}, "enum": {"items": [{"value": "default"}]}}, {"type": "string", "name": "resourceGroupName", "arg": "$Path.resourceGroupName", "required": true, "format": {"pattern": "^[-\\w\\._\\(\\)]+$", "maxLength": 90, "minLength": 1}}, {"type": "string", "name": "subscriptionId", "arg": "$Path.subscriptionId", "required": true, "format": {"minLength": 1}}]}, "query": {"consts": [{"readOnly": true, "const": true, "default": {"value": "2024-01-01"}, "type": "string", "name": "api-version", "required": true, "format": {"minLength": 1}}]}}, "responses": [{"statusCode": [200], "body": {"json": {"var": "$Instance", "schema": {"type": "object", "props": [{"readOnly": true, "type": "string", "name": "id"}, {"type": "string", "name": "name"}, {"type": "object", "name": "properties", "required": true, "props": [{"readOnly": true, "type": "string", "name": "migrationFailedDetailedReason"}, {"readOnly": true, "type": "string", "name": "migrationFailedReason"}, {"readOnly": true, "type": "string", "name": "migrationStatus", "enum": {"items": [{"value": "Complete"}, {"value": "Failed"}, {"value": "InProgress"}, {"value": "Invalid"}, {"value": "SubmittedForConversion"}]}}, {"type": "string", "name": "targetSkuName", "required": true, "enum": {"items": [{"value": "PremiumV2_LRS"}, {"value": "PremiumV2_ZRS"}, {"value": "Premium_LRS"}, {"value": "Premium_ZRS"}, {"value": "StandardV2_GRS"}, {"value": "StandardV2_GZRS"}, {"value": "StandardV2_LRS"}, {"value": "StandardV2_ZRS"}, {"value": "Standard_GRS"}, {"value": "Standard_GZRS"}, {"value": "Standard_LRS"}, {"value": "Standard_RAGRS"}, {"value": "Standard_RAGZRS"}, {"value": "Standard_ZRS"}]}}], "clientFlatten": true}, {"type": "string", "name": "type"}]}}}}, {"isError": true, "body": {"json": {"schema": {"type": "@MgmtErrorFormat"}}}}]}}], "outputs": [{"type": "object", "ref": "$Instance", "clientFlatten": true}], "confirmation": ""}]}]}
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
<?xml version='1.0' encoding='utf-8'?>
2+
<CodeGen plane="mgmt-plane">
3+
<resource id="/subscriptions/{}/resourcegroups/{}/providers/microsoft.storage/storageaccounts/{}/accountmigrations/{}" version="2024-01-01" swagger="mgmt-plane/storage/ResourceProviders/Microsoft.Storage/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9yZXNvdXJjZUdyb3Vwcy97cmVzb3VyY2VHcm91cE5hbWV9L3Byb3ZpZGVycy9NaWNyb3NvZnQuU3RvcmFnZS9zdG9yYWdlQWNjb3VudHMve2FjY291bnROYW1lfS9hY2NvdW50TWlncmF0aW9ucy97bWlncmF0aW9uTmFtZX0=/V/MjAyNC0wMS0wMQ=="/>
4+
<commandGroup name="storage account migration">
5+
<command name="show" version="2024-01-01" confirmation="">
6+
<resource id="/subscriptions/{}/resourcegroups/{}/providers/microsoft.storage/storageaccounts/{}/accountmigrations/{}" version="2024-01-01" swagger="mgmt-plane/storage/ResourceProviders/Microsoft.Storage/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9yZXNvdXJjZUdyb3Vwcy97cmVzb3VyY2VHcm91cE5hbWV9L3Byb3ZpZGVycy9NaWNyb3NvZnQuU3RvcmFnZS9zdG9yYWdlQWNjb3VudHMve2FjY291bnROYW1lfS9hY2NvdW50TWlncmF0aW9ucy97bWlncmF0aW9uTmFtZX0=/V/MjAyNC0wMS0wMQ=="/>
7+
<argGroup name="">
8+
<arg type="string" var="$Path.accountName" options="account-name" required="True" idPart="name">
9+
<help short="The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only."/>
10+
<format pattern="^[a-z0-9]+$" maxLength="24" minLength="3"/>
11+
</arg>
12+
<arg type="string" var="$Path.migrationName" options="migration-name name n" required="True" idPart="child_name_1">
13+
<help short="The name of the Storage Account Migration. It should always be 'default'"/>
14+
<format pattern="^[a-z][a-z0-9]*$"/>
15+
<enum>
16+
<item name="default" value="&quot;default&quot;"/>
17+
</enum>
18+
</arg>
19+
<arg type="ResourceGroupName" var="$Path.resourceGroupName" options="resource-group g" required="True" idPart="resource_group"/>
20+
<arg type="SubscriptionId" var="$Path.subscriptionId" options="subscription" required="True" idPart="subscription"/>
21+
</argGroup>
22+
<operation operationId="StorageAccounts_GetCustomerInitiatedMigration">
23+
<http path="/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/accountMigrations/{migrationName}">
24+
<request method="get">
25+
<path>
26+
<param type="string" name="accountName" arg="$Path.accountName" required="True">
27+
<format pattern="^[a-z0-9]+$" maxLength="24" minLength="3"/>
28+
</param>
29+
<param type="string" name="migrationName" arg="$Path.migrationName" required="True">
30+
<format pattern="^[a-z][a-z0-9]*$"/>
31+
<enum>
32+
<item value="&quot;default&quot;"/>
33+
</enum>
34+
</param>
35+
<param type="string" name="resourceGroupName" arg="$Path.resourceGroupName" required="True">
36+
<format pattern="^[-\w\._\(\)]+$" maxLength="90" minLength="1"/>
37+
</param>
38+
<param type="string" name="subscriptionId" arg="$Path.subscriptionId" required="True">
39+
<format minLength="1"/>
40+
</param>
41+
</path>
42+
<query>
43+
<const readOnly="True" const="True" type="string" name="api-version" required="True">
44+
<default value="&quot;2024-01-01&quot;"/>
45+
<format minLength="1"/>
46+
</const>
47+
</query>
48+
</request>
49+
<response statusCode="200">
50+
<body>
51+
<json var="$Instance">
52+
<schema type="object">
53+
<prop readOnly="True" type="string" name="id"/>
54+
<prop type="string" name="name"/>
55+
<prop type="object" name="properties" required="True" clientFlatten="True">
56+
<prop readOnly="True" type="string" name="migrationFailedDetailedReason"/>
57+
<prop readOnly="True" type="string" name="migrationFailedReason"/>
58+
<prop readOnly="True" type="string" name="migrationStatus">
59+
<enum>
60+
<item value="&quot;Complete&quot;"/>
61+
<item value="&quot;Failed&quot;"/>
62+
<item value="&quot;InProgress&quot;"/>
63+
<item value="&quot;Invalid&quot;"/>
64+
<item value="&quot;SubmittedForConversion&quot;"/>
65+
</enum>
66+
</prop>
67+
<prop type="string" name="targetSkuName" required="True">
68+
<enum>
69+
<item value="&quot;PremiumV2_LRS&quot;"/>
70+
<item value="&quot;PremiumV2_ZRS&quot;"/>
71+
<item value="&quot;Premium_LRS&quot;"/>
72+
<item value="&quot;Premium_ZRS&quot;"/>
73+
<item value="&quot;StandardV2_GRS&quot;"/>
74+
<item value="&quot;StandardV2_GZRS&quot;"/>
75+
<item value="&quot;StandardV2_LRS&quot;"/>
76+
<item value="&quot;StandardV2_ZRS&quot;"/>
77+
<item value="&quot;Standard_GRS&quot;"/>
78+
<item value="&quot;Standard_GZRS&quot;"/>
79+
<item value="&quot;Standard_LRS&quot;"/>
80+
<item value="&quot;Standard_RAGRS&quot;"/>
81+
<item value="&quot;Standard_RAGZRS&quot;"/>
82+
<item value="&quot;Standard_ZRS&quot;"/>
83+
</enum>
84+
</prop>
85+
</prop>
86+
<prop type="string" name="type"/>
87+
</schema>
88+
</json>
89+
</body>
90+
</response>
91+
<response isError="True">
92+
<body>
93+
<json>
94+
<schema type="@MgmtErrorFormat"/>
95+
</json>
96+
</body>
97+
</response>
98+
</http>
99+
</operation>
100+
<output type="object" ref="$Instance" clientFlatten="True"/>
101+
</command>
102+
</commandGroup>
103+
</CodeGen>
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"plane": "mgmt-plane", "resources": [{"id": "/subscriptions/{}/resourcegroups/{}/providers/microsoft.storage/storageaccounts/{}/startaccountmigration", "version": "2024-01-01", "swagger": "mgmt-plane/storage/ResourceProviders/Microsoft.Storage/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9yZXNvdXJjZUdyb3Vwcy97cmVzb3VyY2VHcm91cE5hbWV9L3Byb3ZpZGVycy9NaWNyb3NvZnQuU3RvcmFnZS9zdG9yYWdlQWNjb3VudHMve2FjY291bnROYW1lfS9zdGFydEFjY291bnRNaWdyYXRpb24=/V/MjAyNC0wMS0wMQ=="}], "commandGroups": [{"name": "storage account migration", "commands": [{"name": "start", "version": "2024-01-01", "resources": [{"id": "/subscriptions/{}/resourcegroups/{}/providers/microsoft.storage/storageaccounts/{}/startaccountmigration", "version": "2024-01-01", "swagger": "mgmt-plane/storage/ResourceProviders/Microsoft.Storage/Paths/L3N1YnNjcmlwdGlvbnMve3N1YnNjcmlwdGlvbklkfS9yZXNvdXJjZUdyb3Vwcy97cmVzb3VyY2VHcm91cE5hbWV9L3Byb3ZpZGVycy9NaWNyb3NvZnQuU3RvcmFnZS9zdG9yYWdlQWNjb3VudHMve2FjY291bnROYW1lfS9zdGFydEFjY291bnRNaWdyYXRpb24=/V/MjAyNC0wMS0wMQ=="}], "argGroups": [{"name": "", "args": [{"type": "string", "var": "$Path.accountName", "options": ["account-name"], "required": true, "idPart": "name", "help": {"short": "The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only."}, "format": {"pattern": "^[a-z0-9]+$", "maxLength": 24, "minLength": 3}}, {"type": "ResourceGroupName", "var": "$Path.resourceGroupName", "options": ["g", "resource-group"], "required": true, "idPart": "resource_group"}, {"type": "SubscriptionId", "var": "$Path.subscriptionId", "options": ["subscription"], "required": true, "idPart": "subscription"}]}, {"name": "Parameters", "args": [{"type": "string", "var": "$parameters.name", "options": ["name"], "group": "Parameters", "help": {"short": "current value is 'default' for customer initiated migration"}}, {"type": "string", "var": "$parameters.type", "options": ["type"], "group": "Parameters", "help": {"short": "SrpAccountMigrationType in ARM contract which is 'accountMigrations'"}}]}, {"name": "Properties", "args": [{"type": "string", "var": "$parameters.properties.targetSkuName", "options": ["sku", "target-sku-name"], "required": true, "group": "Properties", "help": {"short": "Target sku name for the account"}, "enum": {"items": [{"name": "PremiumV2_LRS", "value": "PremiumV2_LRS"}, {"name": "PremiumV2_ZRS", "value": "PremiumV2_ZRS"}, {"name": "Premium_LRS", "value": "Premium_LRS"}, {"name": "Premium_ZRS", "value": "Premium_ZRS"}, {"name": "StandardV2_GRS", "value": "StandardV2_GRS"}, {"name": "StandardV2_GZRS", "value": "StandardV2_GZRS"}, {"name": "StandardV2_LRS", "value": "StandardV2_LRS"}, {"name": "StandardV2_ZRS", "value": "StandardV2_ZRS"}, {"name": "Standard_GRS", "value": "Standard_GRS"}, {"name": "Standard_GZRS", "value": "Standard_GZRS"}, {"name": "Standard_LRS", "value": "Standard_LRS"}, {"name": "Standard_RAGRS", "value": "Standard_RAGRS"}, {"name": "Standard_RAGZRS", "value": "Standard_RAGZRS"}, {"name": "Standard_ZRS", "value": "Standard_ZRS"}]}}]}], "operations": [{"longRunning": {"finalStateVia": "location"}, "operationId": "StorageAccounts_CustomerInitiatedMigration", "http": {"path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/startAccountMigration", "request": {"method": "post", "path": {"params": [{"type": "string", "name": "accountName", "arg": "$Path.accountName", "required": true, "format": {"pattern": "^[a-z0-9]+$", "maxLength": 24, "minLength": 3}}, {"type": "string", "name": "resourceGroupName", "arg": "$Path.resourceGroupName", "required": true, "format": {"pattern": "^[-\\w\\._\\(\\)]+$", "maxLength": 90, "minLength": 1}}, {"type": "string", "name": "subscriptionId", "arg": "$Path.subscriptionId", "required": true, "format": {"minLength": 1}}]}, "query": {"consts": [{"readOnly": true, "const": true, "default": {"value": "2024-01-01"}, "type": "string", "name": "api-version", "required": true, "format": {"minLength": 1}}]}, "body": {"json": {"schema": {"type": "object", "name": "parameters", "required": true, "props": [{"type": "string", "name": "name", "arg": "$parameters.name"}, {"type": "object", "name": "properties", "required": true, "props": [{"type": "string", "name": "targetSkuName", "arg": "$parameters.properties.targetSkuName", "required": true, "enum": {"items": [{"value": "PremiumV2_LRS"}, {"value": "PremiumV2_ZRS"}, {"value": "Premium_LRS"}, {"value": "Premium_ZRS"}, {"value": "StandardV2_GRS"}, {"value": "StandardV2_GZRS"}, {"value": "StandardV2_LRS"}, {"value": "StandardV2_ZRS"}, {"value": "Standard_GRS"}, {"value": "Standard_GZRS"}, {"value": "Standard_LRS"}, {"value": "Standard_RAGRS"}, {"value": "Standard_RAGZRS"}, {"value": "Standard_ZRS"}]}}], "clientFlatten": true}, {"type": "string", "name": "type", "arg": "$parameters.type"}], "clientFlatten": true}}}}, "responses": [{"statusCode": [200]}, {"statusCode": [202], "header": {"items": [{"name": "Location"}]}}, {"isError": true, "body": {"json": {"schema": {"type": "@MgmtErrorFormat"}}}}]}}], "confirmation": "After your request to convert the account’s redundancy configuration is validated, the conversion will typically complete in a few days, but can take several weeks depending on current resource demands in the region, account size, and other factors. The conversion can’t be stopped after being initiated, and for accounts with geo redundancy a failover can’t be initiated while conversion is in progress. The data within the storage account will continue to be accessible with no loss of durability or availability. Confirm redundancy configuration change"}]}]}

0 commit comments

Comments
 (0)