Storage Accounts - Customer Initiated Migration

Servizio:: Storage Resource Provider

Versione API:: 2026-04-01

La richiesta di migrazione dell'account può essere attivata per modificare il livello di ridondanza di un account di archiviazione. La migrazione aggiorna l'account di archiviazione con ridondanza non di zona a un account con ridondanza della zona o viceversa per ottenere maggiore affidabilità e disponibilità. Zone-redundant storage (ZRS) replica il tuo account di storage in modo sincrono su tre zone di disponibilità Azure nella regione primaria.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/startAccountMigration?api-version=2026-04-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nome dell'account di archiviazione all'interno del gruppo di risorse specificato. I nomi degli account di archiviazione devono essere di lunghezza compresa tra 3 e 24 caratteri e utilizzare solo numeri e lettere minuscole.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties.targetSkuName	True	SkuName	Nome sku di destinazione per l'account

Risposte

Nome	Tipo	Descrizione
200 OK		Operazione di Azure completata correttamente.
202 Accepted		Operazione sulle risorse accettata. Intestazioni Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

Operazione di Azure completata correttamente.

202 Accepted

Operazione sulle risorse accettata.

Intestazioni

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

StorageAccountPostMigration

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource-group-name/providers/Microsoft.Storage/storageAccounts/accountname/startAccountMigration?api-version=2026-04-01

{
  "properties": {
    "targetSkuName": "Standard_ZRS"
  }
}

Risposta di esempio

Codice di stato:: 200

Codice di stato:: 202

location: https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9101/providers/Microsoft.Storage/locations/eastus/operationResults/00000000-0000-0000-0000-000000000000?api-version=2022-09-01

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
ErrorResponse	Risposta di errore del provider di risorse di archiviazione.
ErrorResponseBody	Contratto del corpo della risposta di errore.
migrationStatus	Stato attuale della migrazione
SkuName	Nome DELLO SKU. Obbligatorio per la creazione dell'account; facoltativo per l'aggiornamento. Si noti che nelle versioni precedenti il nome dello SKU è stato chiamato accountType.
StorageAccountMigration	Parametri o stato associati a una migrazione continuativa o accodata dell'account di archiviazione per aggiornare lo SKU o l'area corrente.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorResponse

Oggetto

Risposta di errore del provider di risorse di archiviazione.

Nome	Tipo	Descrizione
error	ErrorResponseBody	Azure Storage Resource Provider error: corpo di risposta all'errore.

ErrorResponseBody

Oggetto

Contratto del corpo della risposta di errore.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message	string	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

migrationStatus

Enumerazione

Stato attuale della migrazione

Valore	Descrizione
Invalid
SubmittedForConversion
InProgress
Complete
Failed

SkuName

Enumerazione

Nome DELLO SKU. Obbligatorio per la creazione dell'account; facoltativo per l'aggiornamento. Si noti che nelle versioni precedenti il nome dello SKU è stato chiamato accountType.

Valore	Descrizione
Standard_LRS
Standard_GRS
Standard_RAGRS
Standard_ZRS
Premium_LRS
Premium_ZRS
Standard_GZRS
Standard_RAGZRS
StandardV2_LRS
StandardV2_GRS
StandardV2_ZRS
StandardV2_GZRS
PremiumV2_LRS
PremiumV2_ZRS

StorageAccountMigration

Oggetto

Parametri o stato associati a una migrazione continuativa o accodata dell'account di archiviazione per aggiornare lo SKU o l'area corrente.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties.migrationFailedDetailedReason	string	Motivo dell'errore di migrazione
properties.migrationFailedReason	string	Codice di errore per errore di migrazione
properties.migrationStatus	migrationStatus	Stato attuale della migrazione
properties.targetSkuName	SkuName	Nome sku di destinazione per l'account
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.