Snapshots - List All

Servizio:: Azure Stack HCI

Versione API:: 2026-04-01-preview

Elenca tutti gli snapshot nell'abbonamento specificato. Usa la proprietà nextLink nella risposta per ottenere la pagina successiva delle istantanee.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.AzureStackHCI/snapshots?api-version=2026-04-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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.

Risposte

Nome	Tipo	Descrizione
200 OK	SnapshotListResult	L'operazione di Azure è stata completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

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

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

List all snapshots in a subscription

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/providers/Microsoft.AzureStackHCI/snapshots?api-version=2026-04-01-preview

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "name": "test-snapshot-1",
      "type": "Microsoft.AzureStackHCI/snapshots",
      "extendedLocation": {
        "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
        "type": "CustomLocation"
      },
      "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/snapshots/test-snapshot-1",
      "location": "West US2",
      "tags": {
        "environment": "test"
      },
      "properties": {
        "creationData": {
          "createOption": "Copy",
          "sourceResourceId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/virtualHardDisks/source-vhd",
          "sourceUniqueId": "b99c94ca-e43d-4282-9c78-84d58e5ce81a"
        },
        "provisioningState": "Succeeded",
        "timeCreated": "2023-11-15T10:30:00Z",
        "diskSizeBytes": 68719476736,
        "uniqueId": "f9e8d7c6-b5a4-9382-7160-5948372615a3",
        "status": {
          "provisioningStatus": {
            "status": "Succeeded"
          }
        }
      }
    },
    {
      "name": "test-snapshot-2",
      "type": "Microsoft.AzureStackHCI/snapshots",
      "extendedLocation": {
        "name": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
        "type": "CustomLocation"
      },
      "id": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/other-rg/providers/Microsoft.AzureStackHCI/snapshots/test-snapshot-2",
      "location": "East US",
      "properties": {
        "creationData": {
          "createOption": "Copy",
          "sourceResourceId": "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/other-rg/providers/Microsoft.AzureStackHCI/virtualHardDisks/another-vhd",
          "sourceUniqueId": "c11a94ca-e43d-4282-9c78-84d58e5ce81b"
        },
        "provisioningState": "Succeeded",
        "timeCreated": "2023-11-16T08:30:00Z",
        "diskSizeBytes": 137438953472,
        "uniqueId": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
        "status": {
          "provisioningStatus": {
            "status": "Succeeded"
          }
        }
      }
    }
  ]
}

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
CreationData	Dati utilizzati nella creazione di un disco o di uno snapshot
DiskCreateOption	Valori delle opzioni di creazione del disco [Copia, Vuoto]
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExtendedLocation	Tipo complesso della posizione estesa.
ExtendedLocationTypes	Tipo di extendedLocation.
ProvisioningStateEnum	Stato di provisioning della risorsa.
Snapshot	La definizione della risorsa snapshot.
SnapshotListResult	La risposta di un'operazione di lista Snapshot.
SnapshotProperties	Proprietà sotto la risorsa snapshot
SnapshotStatus	Lo stato osservato delle istantanee
SnapshotStatusProvisioningStatus	Stato di provisioning dello stato dello snapshot
Status	Stato dell'operazione eseguita sulla risorsa [Succeeded, Failed, InProgress]
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

CreationData

Oggetto

Dati utilizzati nella creazione di un disco o di uno snapshot

Nome	Tipo	Descrizione
createOption	DiskCreateOption	Questo elenca le possibili fonti della creazione di un disco
sourceResourceId	string (arm-id)	ID ARM della risorsa sorgente utilizzata per la creazione del disco. Richiesto quando createOption è Copia
sourceUniqueId	string	ID unico della risorsa sorgente utilizzata per la creazione del disco. Sola lettura e non necessario per la creazione del disco.

DiskCreateOption

Enumerazione

Valori delle opzioni di creazione del disco [Copia, Vuoto]

Valore	Descrizione
Copy	Crea un disco copiando da una risorsa sorgente
Empty	Crea un disco vuoto

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExtendedLocation

Oggetto

Tipo complesso della posizione estesa.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationTypes	Tipo dell'ubicazione estesa.

ExtendedLocationTypes

Enumerazione

Tipo di extendedLocation.

Valore	Descrizione
CustomLocation	Tipo di percorso esteso personalizzato

ProvisioningStateEnum

Enumerazione

Stato di provisioning della risorsa.

Valore	Descrizione
Succeeded	Provisioning completato
Failed	Provisioning non riuscito
InProgress	Il provisioning è in corso
Accepted	Il provisioning è stato accettato
Deleting	Eliminazione della risorsa in corso
Canceled	Il provisioning è stato annullato

Snapshot

Oggetto

La definizione della risorsa snapshot.

Nome	Tipo	Descrizione
extendedLocation	ExtendedLocation	ExtendedLocation della risorsa.
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties	SnapshotProperties	Proprietà specifiche della risorsa.
systemData	systemData	Metadati di Azure Resource Manager contenenti informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SnapshotListResult

Oggetto

La risposta di un'operazione di lista Snapshot.

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	Snapshot[]	Gli elementi Snapshot in questa pagina

SnapshotProperties

Oggetto

Proprietà sotto la risorsa snapshot

Nome	Tipo	Descrizione
creationData	CreationData	Dati utilizzati per creare uno snapshot
diskSizeBytes	integer (int64)	La dimensione del disco in byte.
provisioningState	ProvisioningStateEnum	Stato di provisioning dello snapshot.
status	SnapshotStatus	Lo stato osservato delle istantanee
timeCreated	string (date-time)	Ora di creazione dello snapshot.
uniqueId	string	Identificatore univoco per lo snapshot.

SnapshotStatus

Oggetto

Lo stato osservato delle istantanee

Nome	Tipo	Descrizione
errorCode	string	Codice di errore per la provisioning snapshot
errorMessage	string	Messaggio di errore descrittivo
provisioningStatus	SnapshotStatusProvisioningStatus	Stato di provisioning dello snapshot

SnapshotStatusProvisioningStatus

Oggetto

Stato di provisioning dello stato dello snapshot

Nome	Tipo	Descrizione
operationId	string	L'ID dell'operazione eseguita sull'istantaneo
status	Status	Lo stato dell'operazione eseguita sull'istantaneo [Riuscito, Fallito, In corso]

Status

Enumerazione

Stato dell'operazione eseguita sulla risorsa [Succeeded, Failed, InProgress]

Valore	Descrizione
Succeeded	Operazione riuscita
Failed	Operazione non riuscita
InProgress	L'operazione è in corso

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)	Il 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.

Condividi tramite

Snapshots - List All

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

List all snapshots in a subscription

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

CreationData

DiskCreateOption

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

ProvisioningStateEnum

Snapshot

SnapshotListResult

SnapshotProperties

SnapshotStatus

SnapshotStatusProvisioningStatus

Status

systemData