Snapshots - List All

Usługa:: Azure Stack HCI

Wersja interfejsu API:: 2026-04-01-preview

Lista wszystkich migawek w określonej subskrypcji. Użyj właściwości nextLink w odpowiedzi, aby uzyskać następną stronę ze snapshotami.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	SnapshotListResult	Operacja platformy Azure została zakończona pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

List all snapshots in a subscription

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

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

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
CreationData	Dane używane podczas tworzenia dysku lub migawki
DiskCreateOption	Wartości opcji tworzenia dysku [Kopiuj, Pusty]
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ExtendedLocation	Typ złożony lokalizacji rozszerzonej.
ExtendedLocationTypes	Typ extendedLocation.
ProvisioningStateEnum	Stan aprowizacji zasobu.
Snapshot	Definicja zasobów migawkowa.
SnapshotListResult	Odpowiedź operacji Snapshot list.
SnapshotProperties	Właściwości pod zasobem snapshot
SnapshotStatus	Obserwowany stan migawek
SnapshotStatusProvisioningStatus	Status przydzielania statusu migawki
Status	Stan operacji wykonanej na zasobie [Powodzenie, Niepowodzenie, InProgress]
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

CreationData

Objekt

Dane używane podczas tworzenia dysku lub migawki

Nazwa	Typ	Opis
createOption	DiskCreateOption	To wymienia możliwe źródła powstania dysku
sourceResourceId	string (arm-id)	Identyfikator ARM zasobu źródłowego używanego do tworzenia dysku. Wymagane, gdy createOption jest Copy
sourceUniqueId	string	Unikalny identyfikator zasobu źródłowego użytego do tworzenia dysku. Tylko do odczytu i nie jest wymagane do tworzenia dysku.

DiskCreateOption

Wyliczenie

Wartości opcji tworzenia dysku [Kopiuj, Pusty]

Wartość	Opis
Copy	Utwórz dysk, kopiując go z zasobu źródłowego
Empty	Stwórz pustą płytę

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Błąd dodatkowe informacje.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Cel błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExtendedLocation

Objekt

Typ złożony lokalizacji rozszerzonej.

Nazwa	Typ	Opis
name	string	Nazwa lokalizacji rozszerzonej.
type	ExtendedLocationTypes	Typ lokalizacji rozszerzonej.

ExtendedLocationTypes

Wyliczenie

Typ extendedLocation.

Wartość	Opis
CustomLocation	Niestandardowy typ lokalizacji rozszerzonej

ProvisioningStateEnum

Wyliczenie

Stan aprowizacji zasobu.

Wartość	Opis
Succeeded	Inicjowanie obsługi administracyjnej zakończyło się pomyślnie
Failed	Inicjowanie obsługi administracyjnej nie powiodło się
InProgress	Inicjowanie obsługi administracyjnej jest w toku
Accepted	Aprowizacja została zaakceptowana
Deleting	Usuwanie zasobu jest w toku
Canceled	Aprowizacja została anulowana

Snapshot

Objekt

Definicja zasobów migawkowa.

Nazwa	Typ	Opis
extendedLocation	ExtendedLocation	ExtendedLocation zasobu.
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties	SnapshotProperties	Właściwości specyficzne dla zasobu dla tego zasobu.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

SnapshotListResult

Objekt

Odpowiedź operacji Snapshot list.

Nazwa	Typ	Opis
nextLink	string (uri)	Link do następnej strony elementów
value	Snapshot[]	Elementy migawki na tej stronie

SnapshotProperties

Objekt

Właściwości pod zasobem snapshot

Nazwa	Typ	Opis
creationData	CreationData	Dane używane podczas tworzenia migawki
diskSizeBytes	integer (int64)	Rozmiar dysku w bajtach.
provisioningState	ProvisioningStateEnum	Stan provisioningu snapshotu.
status	SnapshotStatus	Obserwowany stan migawek
timeCreated	string (date-time)	Godzina utworzenia migawki.
uniqueId	string	Unikalny identyfikator dla snapshota.

SnapshotStatus

Objekt

Obserwowany stan migawek

Nazwa	Typ	Opis
errorCode	string	Kod błędu provisioningu migawek
errorMessage	string	Opisowy komunikat o błędzie
provisioningStatus	SnapshotStatusProvisioningStatus	Status udostępniania snapshotu

SnapshotStatusProvisioningStatus

Objekt

Status przydzielania statusu migawki

Nazwa	Typ	Opis
operationId	string	ID operacji wykonanej na migawce
status	Status	Status operacji wykonanej na migawce [Zakończyło się, Niepowodzenie, W trakcie postępowania]

Status

Wyliczenie

Stan operacji wykonanej na zasobie [Powodzenie, Niepowodzenie, InProgress]

Wartość	Opis
Succeeded	Operacja powiodła się
Failed	Operacja nie powiodła się
InProgress	Operacja jest w toku

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem

Snapshots - List All

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

List all snapshots in a subscription

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

createdByType

CreationData

DiskCreateOption

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

ProvisioningStateEnum

Snapshot

SnapshotListResult

SnapshotProperties

SnapshotStatus

SnapshotStatusProvisioningStatus

Status

systemData