Snapshots - List All

Служба:: Azure Stack HCI

Версия API:: 2026-04-01-preview

Перечисляет все снимки в указанной подписке. Используйте свойство nextLink в ответе, чтобы получить следующую страницу снимков.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	SnapshotListResult	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	Выдача себя за свою учетную запись пользователя

Примеры

List all snapshots in a subscription

Образец запроса

HTTP

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

Пример ответа

Код состояния:: 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"
          }
        }
      }
    }
  ]
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
CreationData	Данные, используемые при создании диска или снимка
DiskCreateOption	Значения опции создания диска [Скопировать, пусто]
ErrorAdditionalInfo	Ошибка управления ресурсами дополнительная информация.
ErrorDetail	Детали ошибки.
ErrorResponse	Ответ на ошибку
ExtendedLocation	Сложный тип расширенного расположения.
ExtendedLocationTypes	Тип extendedLocation.
ProvisioningStateEnum	Состояние подготовки ресурса.
Snapshot	Определение ресурса с изображением снимка.
SnapshotListResult	Реакция операции Snapshot list.
SnapshotProperties	Свойства ресурса снимка
SnapshotStatus	Наблюдаемое состояние снимков
SnapshotStatusProvisioningStatus	Статус предоставления статуса снимков
Status	Состояние операции, выполняемой на ресурсе [Выполнено, сбой, InProgress]
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

CreationData

Объект

Данные, используемые при создании диска или снимка

Имя	Тип	Описание
createOption	DiskCreateOption	Это перечисляет возможные источники создания диска
sourceResourceId	string (arm-id)	ARM ID исходного ресурса, используемого для создания диска. Требуется, когда createOption — Копировать
sourceUniqueId	string	Уникальный идентификатор исходного ресурса, используемого для создания диска. Только для чтения и не требуется для создания диска.

DiskCreateOption

Перечисление

Значения опции создания диска [Скопировать, пусто]

Значение	Описание
Copy	Создайте диск путём копирования из исходного ресурса
Empty	Создать пустой диск

ErrorAdditionalInfo

Объект

Ошибка управления ресурсами дополнительная информация.

Имя	Тип	Описание
info	object	Дополнительная информация.
type	string	Тип дополнительной информации.

ErrorDetail

Объект

Детали ошибки.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Ошибка дополнительная информация.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

ExtendedLocation

Объект

Сложный тип расширенного расположения.

Имя	Тип	Описание
name	string	Имя расширенного расположения.
type	ExtendedLocationTypes	Тип расширенного расположения.

ExtendedLocationTypes

Перечисление

Тип extendedLocation.

Значение	Описание
CustomLocation	Тип настраиваемого расширенного расположения

ProvisioningStateEnum

Перечисление

Состояние подготовки ресурса.

Значение	Описание
Succeeded	Подготовка выполнена успешно
Failed	Сбой подготовки
InProgress	Подготовка выполняется
Accepted	Подготовка была принята
Deleting	Выполняется удаление ресурса
Canceled	Подготовка отменена

Snapshot

Объект

Определение ресурса с изображением снимка.

Имя	Тип	Описание
extendedLocation	ExtendedLocation	Расширенное размещение ресурса.
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса.
properties	SnapshotProperties	Свойства, относящиеся к ресурсу, для этого ресурса.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

SnapshotListResult

Объект

Реакция операции Snapshot list.

Имя	Тип	Описание
nextLink	string (uri)	Ссылка на следующую страницу элементов
value	Snapshot[]	Элементы моментального снимка на этой странице

SnapshotProperties

Объект

Свойства ресурса снимка

Имя	Тип	Описание
creationData	CreationData	Данные, используемые при создании снимка
diskSizeBytes	integer (int64)	Размер диска в байтах.
provisioningState	ProvisioningStateEnum	Состояние предоставления снимка.
status	SnapshotStatus	Наблюдаемое состояние снимков
timeCreated	string (date-time)	Время создания моментального снимка.
uniqueId	string	Уникальный идентификатор для снимка.

SnapshotStatus

Объект

Наблюдаемое состояние снимков

Имя	Тип	Описание
errorCode	string	Код ошибки при оформлении снимков
errorMessage	string	Описательное сообщение об ошибке
provisioningStatus	SnapshotStatusProvisioningStatus	Статус предоставления снимка

SnapshotStatusProvisioningStatus

Объект

Статус предоставления статуса снимков

Имя	Тип	Описание
operationId	string	ID операции, выполненной на снимке
status	Status	Статус операции, выполненной на снимке [Успешно, Невыполнено, В процессе]

Status

Перечисление

Состояние операции, выполняемой на ресурсе [Выполнено, сбой, InProgress]

Значение	Описание
Succeeded	Операция выполнена успешно
Failed	Сбой операции
InProgress	Операция выполняется

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Временная метка последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Поделиться через

Snapshots - List All

Параметры URI

Ответы

Безопасность

azure_auth

Области

Примеры

List all snapshots in a subscription

Образец запроса

Пример ответа

Определения

createdByType

CreationData

DiskCreateOption

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

ExtendedLocationTypes

ProvisioningStateEnum

Snapshot

SnapshotListResult

SnapshotProperties

SnapshotStatus

SnapshotStatusProvisioningStatus

Status

systemData