Snapshots - List All

Dienst:: Azure Stack HCI

API-Version:: 2026-04-01-preview

Listet alle Snapshots im angegebenen Abonnement auf. Verwenden Sie die NextLink-Eigenschaft in der Antwort, um die nächste Seite mit Snapshots zu erhalten.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	SnapshotListResult	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

List all snapshots in a subscription

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 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"
          }
        }
      }
    }
  ]
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CreationData	Daten, die beim Erstellen einer Festplatte oder eines Snapshots verwendet werden
DiskCreateOption	Optionswerte zur Festplattenerstellung [Kopieren, Leeren]
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ExtendedLocation	Der komplexe Typ des erweiterten Standorts.
ExtendedLocationTypes	Der Typ von extendedLocation.
ProvisioningStateEnum	Bereitstellungsstatus der Ressource.
Snapshot	Die Definition der Snapshot-Ressourcen.
SnapshotListResult	Die Antwort einer Snapshot-Listenoperation.
SnapshotProperties	Eigenschaften unter der Snapshot-Ressource
SnapshotStatus	Der beobachtete Zustand von Schnappschüssen
SnapshotStatusProvisioningStatus	Snapshot Status der Bereitstellung
Status	Der Status des Vorgangs, der für die Ressource ausgeführt wurde [Erfolgreich, Fehlgeschlagen, InProgress]
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

CreationData

Objekt

Daten, die beim Erstellen einer Festplatte oder eines Snapshots verwendet werden

Name	Typ	Beschreibung
createOption	DiskCreateOption	Dies zählt die möglichen Quellen der Entstehung einer Scheibe auf
sourceResourceId	string (arm-id)	ARM-ID der Quellressource, die für die Festplattenerstellung verwendet wird. Erforderlich, wenn createOption kopiert ist
sourceUniqueId	string	Eindeutige ID der Quellressource, die für die Festplattenerstellung verwendet wird. Schreibgeschützt und nicht erforderlich für die Erstellung der Festplatten.

DiskCreateOption

Enumeration

Optionswerte zur Festplattenerstellung [Kopieren, Leeren]

Wert	Beschreibung
Copy	Erstellen Sie eine Festplatte durch Kopieren von einer Quellressource
Empty	Eine leere Festplatte erstellen

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ExtendedLocation

Objekt

Der komplexe Typ des erweiterten Standorts.

Name	Typ	Beschreibung
name	string	Der Name des erweiterten Speicherorts.
type	ExtendedLocationTypes	Der Typ des erweiterten Speicherorts.

ExtendedLocationTypes

Enumeration

Der Typ von extendedLocation.

Wert	Beschreibung
CustomLocation	Benutzerdefinierter erweiterter Standorttyp

ProvisioningStateEnum

Enumeration

Bereitstellungsstatus der Ressource.

Wert	Beschreibung
Succeeded	Die Bereitstellung ist erfolgreich.
Failed	Fehler bei der Bereitstellung
InProgress	Die Bereitstellung wird ausgeführt.
Accepted	Die Bereitstellung wurde akzeptiert.
Deleting	Das Löschen der Ressource wird ausgeführt.
Canceled	Die Bereitstellung wurde abgebrochen.

Snapshot

Objekt

Die Definition der Snapshot-Ressourcen.

Name	Typ	Beschreibung
extendedLocation	ExtendedLocation	Die extendedLocation der Ressource.
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties	SnapshotProperties	Die ressourcenspezifischen Eigenschaften für diese Ressource.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

SnapshotListResult

Objekt

Die Antwort einer Snapshot-Listenoperation.

Name	Typ	Beschreibung
nextLink	string (uri)	Der Link zur nächsten Seite der Elemente
value	Snapshot[]	Die Snapshot-Elemente auf dieser Seite

SnapshotProperties

Objekt

Eigenschaften unter der Snapshot-Ressource

Name	Typ	Beschreibung
creationData	CreationData	Daten, die bei der Erstellung eines Snapshots verwendet werden
diskSizeBytes	integer (int64)	Die Größe des Datenträgers in Bytes.
provisioningState	ProvisioningStateEnum	Bereitstellungszustand des Snapshots.
status	SnapshotStatus	Der beobachtete Zustand von Schnappschüssen
timeCreated	string (date-time)	Der Zeitpunkt, zu dem die Momentaufnahme erstellt wurde.
uniqueId	string	Eindeutige Kennung für den Schnappschuss.

SnapshotStatus

Objekt

Der beobachtete Zustand von Schnappschüssen

Name	Typ	Beschreibung
errorCode	string	Snapshot-Bereitstellungsfehlercode
errorMessage	string	Beschreibende Fehlermeldung
provisioningStatus	SnapshotStatusProvisioningStatus	Bereitstellungsstatus des Snapshots

SnapshotStatusProvisioningStatus

Objekt

Snapshot Status der Bereitstellung

Name	Typ	Beschreibung
operationId	string	Die ID der auf dem Snapshot durchgeführten Operation
status	Status	Der Status der auf dem Snapshot durchgeführten Operation [Erfolgreich, Fehlgeschlagen, InLaufen]

Status

Enumeration

Der Status des Vorgangs, der für die Ressource ausgeführt wurde [Erfolgreich, Fehlgeschlagen, InProgress]

Wert	Beschreibung
Succeeded	Vorgang erfolgreich
Failed	Fehler beim Vorgang.
InProgress	Der Vorgang wird ausgeführt.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über

Snapshots - List All

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

List all snapshots in a subscription

Beispielanforderung

Beispiel für eine Antwort

Definitionen

createdByType

CreationData

DiskCreateOption

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

ProvisioningStateEnum

Snapshot

SnapshotListResult

SnapshotProperties

SnapshotStatus

SnapshotStatusProvisioningStatus

Status

systemData