Shared Gallery Images - Get

서비스:: Compute

API 버전:: 2024-03-03

구독 ID 또는 테넌트 ID로 공유 갤러리 이미지를 가져옵니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
galleryImageName	path	True	string	이미지 버전이 나열될 공유 갤러리 이미지 정의의 이름입니다.
galleryUniqueName	path	True	string	공유 갤러리의 고유한 이름입니다.
location	path	True	string minLength: 1	Azure 지역의 이름입니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	SharedGalleryImage	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	CloudError	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
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"
  }
}

정의

Name	Description
ApiError	API 오류.
ApiErrorBase	API 오류 기반.
Architecture	이미지의 아키텍처입니다. OS 디스크에만 적용됩니다.
CloudError	컴퓨팅 서비스의 오류 응답입니다.
Disallowed	허용되지 않는 디스크 유형에 대해 설명합니다.
GalleryImageFeature	갤러리 이미지를 위한 기능입니다.
GalleryImageIdentifier	갤러리 이미지 정의 식별자입니다.
HyperVGeneration	Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.
ImagePurchasePlan	갤러리 이미지 정의 구매 계획을 설명합니다. 이는 마켓플레이스 이미지에서 사용됩니다.
InnerError	내부 오류 세부 정보입니다.
OperatingSystemStateTypes	이 속성을 사용하면 사용자가 이 이미지에서 만든 가상 머신이 '일반화됨' 또는 '특수화'인지 여부를 지정할 수 있습니다.
OperatingSystemTypes	이 속성을 사용하면 관리되는 이미지에서 VM을 만들 때 디스크에 포함된 OS 유형을 지정할 수 있습니다. 가능한 값은 Windows,Linux입니다.
RecommendedMachineConfiguration	속성은 이 이미지 정의에 권장되는 컴퓨터 구성을 설명합니다. 이러한 속성은 업다이블할 수 있습니다.
ResourceRange	리소스 범위를 설명합니다.
SharedGalleryImage	만들거나 업데이트하려는 갤러리 이미지 정의에 대한 정보를 지정합니다.

ApiError

Object

API 오류.

Name	형식	Description
code	string	오류 코드입니다.
details	ApiErrorBase[]	Api 오류 세부 정보
innererror	InnerError	Api 내부 오류
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

ApiErrorBase

Object

API 오류 기반.

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

Architecture

열거형

이미지의 아키텍처입니다. OS 디스크에만 적용됩니다.

값	Description
x64
Arm64

CloudError

Object

컴퓨팅 서비스의 오류 응답입니다.

Name	형식	Description
error	ApiError	API 오류.

Disallowed

Object

허용되지 않는 디스크 유형에 대해 설명합니다.

Name	형식	Description
diskTypes	string[]	디스크 유형 목록입니다.

GalleryImageFeature

Object

갤러리 이미지를 위한 기능입니다.

Name	형식	Description
name	string	갤러리 이미지 기능의 이름입니다.
startsAtVersion	string	이 기능을 지원하는 최소 갤러리 이미지 버전입니다.
value	string	갤러리 이미지 기능의 값입니다.

GalleryImageIdentifier

Object

갤러리 이미지 정의 식별자입니다.

Name	형식	Description
offer	string	갤러리 이미지 정의 제품의 이름입니다.
publisher	string	갤러리 이미지 정의 게시자의 이름입니다.
sku	string	갤러리 이미지 정의 SKU의 이름입니다.

HyperVGeneration

열거형

Virtual Machine의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.

값	Description
V1
V2

ImagePurchasePlan

Object

갤러리 이미지 정의 구매 계획을 설명합니다. 이는 마켓플레이스 이미지에서 사용됩니다.

Name	형식	Description
name	string	계획 ID입니다.
product	string	제품 ID입니다.
publisher	string	게시자 ID입니다.

InnerError

Object

내부 오류 세부 정보입니다.

Name	형식	Description
errordetail	string	내부 오류 메시지 또는 예외 덤프입니다.
exceptiontype	string	예외 유형입니다.

OperatingSystemStateTypes

열거형

이 속성을 사용하면 사용자가 이 이미지에서 만든 가상 머신이 '일반화됨' 또는 '특수화'인지 여부를 지정할 수 있습니다.

값	Description
Generalized	일반화된 이미지. 배포 시간 동안 프로비저닝해야 합니다.
Specialized	특화된 이미지. 이미 프로비전된 OS 디스크를 포함합니다.

OperatingSystemTypes

열거형

이 속성을 사용하면 관리되는 이미지에서 VM을 만들 때 디스크에 포함된 OS 유형을 지정할 수 있습니다. 가능한 값은 Windows,Linux입니다.

값	Description
Windows
Linux

RecommendedMachineConfiguration

Object

속성은 이 이미지 정의에 권장되는 컴퓨터 구성을 설명합니다. 이러한 속성은 업다이블할 수 있습니다.

Name	형식	Description
memory	ResourceRange	리소스 범위를 설명합니다.
vCPUs	ResourceRange	리소스 범위를 설명합니다.

ResourceRange

Object

리소스 범위를 설명합니다.

Name	형식	Description
max	integer (int32)	리소스의 최대 수입니다.
min	integer (int32)	리소스의 최소 수입니다.