Shared Gallery Images - Get

Служба:: Compute

Версия API:: 2024-03-03

Получите изображение общей коллекции по идентификатору подписки или идентификатору клиента.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}?api-version=2024-03-03

Параметры URI

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

Ответы

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

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Get a shared gallery image.

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

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/myLocation/sharedGalleries/galleryUniqueName/images/myGalleryImageName?api-version=2024-03-03

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

Код состояния:: 200

{
  "properties": {
    "osType": "Windows",
    "osState": "Generalized",
    "hyperVGeneration": "V1",
    "identifier": {
      "publisher": "myPublisherName",
      "offer": "myOfferName",
      "sku": "mySkuName"
    },
    "eula": "https://www.microsoft.com/en-us/",
    "artifactTags": {
      "ShareTag-Official1PGallery": "Official1PGallery"
    }
  },
  "location": "myLocation",
  "name": "myGalleryImageName",
  "identifier": {
    "uniqueId": "/SharedGalleries/galleryUniqueName/Images/myGalleryImageName"
  }
}

Определения

Имя	Описание
ApiError	Ошибка API.
ApiErrorBase	База ошибок API.
Architecture	Архитектура образа. Применимо только к дискам ОС.
CloudError	Ответ об ошибке от службы вычислений.
Disallowed	Описывает запрещенные типы дисков.
GalleryImageFeature	Функция для галереи изображений.
GalleryImageIdentifier	Это идентификатор определения образа коллекции.
HyperVGeneration	Создание гипервизора виртуальной машины. Применимо только к дискам ОС.
ImagePurchasePlan	Описывает план приобретения определения образа коллекции. Это используется изображениями Marketplace.
InnerError	Сведения о внутренней ошибке.
OperatingSystemStateTypes	Это свойство позволяет пользователю указать, являются ли виртуальные машины, созданные на этом изображении, "Обобщенными" или "Специализированными".
OperatingSystemTypes	Это свойство позволяет указать тип ОПЕРАЦИОННОй системы, включенной в диск при создании виртуальной машины из управляемого образа. Возможные значения: Windows,Linux.
RecommendedMachineConfiguration	Свойства описывают рекомендуемую конфигурацию компьютера для этого определения образа. Эти свойства являются обновляемыми.
ResourceRange	Описывает диапазон ресурсов.
SharedGalleryImage	Указывает сведения об определении изображения галереи, которое требуется создать или обновить.

ApiError

Объект

Ошибка API.

Имя	Тип	Описание
code	string	Код ошибки.
details	ApiErrorBase[]	Сведения об ошибке Api
innererror	InnerError	Внутренняя ошибка Api
message	string	Сообщение об ошибке.
target	string	Целевой объект конкретной ошибки.

ApiErrorBase

Объект

База ошибок API.

Имя	Тип	Описание
code	string	Код ошибки.
message	string	Сообщение об ошибке.
target	string	Целевой объект конкретной ошибки.

Architecture

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

Архитектура образа. Применимо только к дискам ОС.

Значение	Описание
x64
Arm64

CloudError

Объект

Ответ об ошибке от службы вычислений.

Имя	Тип	Описание
error	ApiError	Ошибка API.

Disallowed

Объект

Описывает запрещенные типы дисков.

Имя	Тип	Описание
diskTypes	string[]	Список типов дисков.

GalleryImageFeature

Объект

Функция для галереи изображений.

Имя	Тип	Описание
name	string	Имя функции изображения коллекции.
startsAtVersion	string	Минимальная версия образа коллекции, которая поддерживает эту функцию.
value	string	Значение функции изображения коллекции.

GalleryImageIdentifier

Объект

Это идентификатор определения образа коллекции.

Имя	Тип	Описание
offer	string	Имя предложения определения изображения коллекции.
publisher	string	Имя издателя определения образа коллекции.
sku	string	Имя номера SKU определения образа коллекции.

HyperVGeneration

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

Создание гипервизора виртуальной машины. Применимо только к дискам ОС.

Значение	Описание
V1
V2

ImagePurchasePlan

Объект

Описывает план приобретения определения образа коллекции. Это используется изображениями Marketplace.

Имя	Тип	Описание
name	string	Идентификатор плана.
product	string	Идентификатор продукта.
publisher	string	Идентификатор издателя.

InnerError

Объект

Сведения о внутренней ошибке.

Имя	Тип	Описание
errordetail	string	Внутреннее сообщение об ошибке или дамп исключений.
exceptiontype	string	Тип исключения.

OperatingSystemStateTypes

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

Это свойство позволяет пользователю указать, являются ли виртуальные машины, созданные на этом изображении, "Обобщенными" или "Специализированными".

Значение	Описание
Generalized	Обобщенное изображение. Необходимо подготовить во время развертывания.
Specialized	Специализированное изображение. Содержит уже подготовленный диск ОС.

OperatingSystemTypes

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

Это свойство позволяет указать тип ОПЕРАЦИОННОй системы, включенной в диск при создании виртуальной машины из управляемого образа. Возможные значения: Windows,Linux.

Значение	Описание
Windows
Linux

RecommendedMachineConfiguration

Объект

Свойства описывают рекомендуемую конфигурацию компьютера для этого определения образа. Эти свойства являются обновляемыми.

Имя	Тип	Описание
memory	ResourceRange	Описывает диапазон ресурсов.
vCPUs	ResourceRange	Описывает диапазон ресурсов.

ResourceRange

Объект

Описывает диапазон ресурсов.

Имя	Тип	Описание
max	integer (int32)	Максимальное число ресурсов.
min	integer (int32)	Минимальное количество ресурса.