Snapshots - List All

Služba:: Azure Stack HCI

Verze rozhraní API:: 2026-04-01-preview

Uvádí všechny snímky v daném předplatném. Použijte vlastnost nextLink v odpovědi pro získání další stránky snapshotů.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	SnapshotListResult	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

List all snapshots in a subscription

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
          }
        }
      }
    }
  ]
}

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
CreationData	Data používaná při vytváření disku nebo snímku
DiskCreateOption	Hodnoty volby pro vytvoření disku [Kopírovat, Prázdný]
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ExtendedLocation	Komplexní typ rozšířeného umístění.
ExtendedLocationTypes	Typ extendedLocation.
ProvisioningStateEnum	Stav zřizování prostředku
Snapshot	Definice zdroje na snapshot.
SnapshotListResult	Odpověď operace Snapshot list.
SnapshotProperties	Vlastnosti pod zdrojem snapshot
SnapshotStatus	Pozorovaný stav snímků
SnapshotStatusProvisioningStatus	Stav nastavení stavu snapshot
Status	Stav operace prováděné s prostředkem [Úspěch, Selhání, InProgress]
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

CreationData

Objekt

Data používaná při vytváření disku nebo snímku

Name	Typ	Description
createOption	DiskCreateOption	Tím se vyjmenovávají možné zdroje vzniku disku
sourceResourceId	string (arm-id)	ARM ID zdrojového zdroje používaného pro tvorbu disku. Vyžadováno, když je createOption Copy
sourceUniqueId	string	Unikátní ID zdrojového zdroje používaného pro tvorbu disku. Pouze pro čtení a není potřeba pro tvorbu disku.

DiskCreateOption

Výčet

Hodnoty volby pro vytvoření disku [Kopírovat, Prázdný]

Hodnota	Description
Copy	Vytvořte disk kopírováním ze zdrojového zdroje
Empty	Vytvořte prázdný disk

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExtendedLocation

Objekt

Komplexní typ rozšířeného umístění.

Name	Typ	Description
name	string	Název rozšířeného umístění.
type	ExtendedLocationTypes	Typ rozšířeného umístění.

ExtendedLocationTypes

Výčet

Typ extendedLocation.

Hodnota	Description
CustomLocation	Vlastní rozšířený typ umístění

ProvisioningStateEnum

Výčet

Stav zřizování prostředku

Hodnota	Description
Succeeded	Zřizování bylo úspěšné.
Failed	Zřizování se nezdařilo.
InProgress	Probíhá zřizování.
Accepted	Zřizování bylo přijato.
Deleting	Probíhá odstranění prostředku.
Canceled	Zřizování bylo zrušeno.

Snapshot

Objekt

Definice zdroje na snapshot.

Name	Typ	Description
extendedLocation	ExtendedLocation	ExtendedLocation prostředku.
id	string (arm-id)	Plně kvalifikované ID prostředku pro daný prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties	SnapshotProperties	Vlastnosti specifické pro prostředek pro tento prostředek.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

SnapshotListResult

Objekt

Odpověď operace Snapshot list.

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	Snapshot[]	Položky Snímek na této stránce

SnapshotProperties

Objekt

Vlastnosti pod zdrojem snapshot

Name	Typ	Description
creationData	CreationData	Data použitá při vytváření snímku
diskSizeBytes	integer (int64)	Velikost disku v bajtech.
provisioningState	ProvisioningStateEnum	Stav provisioningu snímku.
status	SnapshotStatus	Pozorovaný stav snímků
timeCreated	string (date-time)	Čas vytvoření snímku
uniqueId	string	Unikátní identifikátor pro snímek.

SnapshotStatus

Objekt

Pozorovaný stav snímků

Name	Typ	Description
errorCode	string	Chybový kód pro provisioning snímků
errorMessage	string	Popisná chybová zpráva
provisioningStatus	SnapshotStatusProvisioningStatus	Stav provisioningu snapshotu

SnapshotStatusProvisioningStatus

Objekt

Stav nastavení stavu snapshot

Name	Typ	Description
operationId	string	ID operace provedené na snapshotu
status	Status	Stav provedené operace na snapshotu [Úspěšně, Neúspěšně, Průběh]

Status

Výčet

Stav operace prováděné s prostředkem [Úspěch, Selhání, InProgress]

Hodnota	Description
Succeeded	Operace byla úspěšná.
Failed	Operace selhala.
InProgress	Probíhá operace.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

Snapshots - List All

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

List all snapshots in a subscription

Ukázkový požadavek

Ukázková odpověď

Definice

createdByType

CreationData

DiskCreateOption

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

ProvisioningStateEnum

Snapshot

SnapshotListResult

SnapshotProperties

SnapshotStatus

SnapshotStatusProvisioningStatus

Status

systemData