Shared Gallery Images - Get
구독 ID 또는 테넌트 ID로 공유 갤러리 이미지를 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/sharedGalleries/{galleryUniqueName}/images/{galleryImageName}?api-version=2023-07-03
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
gallery
|
path | True |
string |
이미지 버전을 나열할 공유 갤러리 이미지 정의의 이름입니다. |
gallery
|
path | True |
string |
공유 갤러리의 고유한 이름입니다. |
location
|
path | True |
string |
리소스 위치. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다. |
api-version
|
query | True |
string |
클라이언트 API 버전. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
Get a shared gallery image.
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/myLocation/sharedGalleries/galleryUniqueName/images/myGalleryImageName?api-version=2023-07-03
Sample Response
{
"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 |
---|---|
Api |
API 오류입니다. |
Api |
API 오류 기준입니다. |
Architecture |
이미지의 아키텍처입니다. OS 디스크에만 적용됩니다. |
Cloud |
Compute 서비스의 오류 응답입니다. |
Disallowed |
허용되지 않는 디스크 유형에 대해 설명합니다. |
Gallery |
갤러리 이미지에 대한 기능입니다. |
Gallery |
갤러리 이미지 정의 식별자입니다. |
Hyper |
가상 머신의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다. |
Image |
갤러리 이미지 정의 구매 계획에 대해 설명합니다. 이는 마켓플레이스 이미지에서 사용됩니다. |
Inner |
내부 오류 세부 정보입니다. |
Operating |
이 속성을 사용하면 사용자가 이 이미지에서 만든 가상 머신이 '일반화됨' 또는 '특수화됨'인지 여부를 지정할 수 있습니다. |
Operating |
이 속성을 사용하면 관리되는 이미지에서 VM을 만들 때 디스크에 포함된 OS 유형을 지정할 수 있습니다. 가능한 값은 Windows,Linux입니다. |
Recommended |
속성은 이 이미지 정의에 권장되는 컴퓨터 구성을 설명합니다. 이러한 속성은 업다이블할 수 있습니다. |
Resource |
리소스 범위를 설명합니다. |
Shared |
만들거나 업데이트하려는 갤러리 이미지 정의에 대한 정보를 지정합니다. |
ApiError
API 오류입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드입니다. |
details |
API 오류 세부 정보 |
|
innererror |
API 내부 오류 |
|
message |
string |
오류 메시지입니다. |
target |
string |
특정 오류의 대상입니다. |
ApiErrorBase
API 오류 기준입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드입니다. |
message |
string |
오류 메시지입니다. |
target |
string |
특정 오류의 대상입니다. |
Architecture
이미지의 아키텍처입니다. OS 디스크에만 적용됩니다.
Name | 형식 | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
CloudError
Compute 서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
API 오류입니다. |
Disallowed
허용되지 않는 디스크 유형에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
diskTypes |
string[] |
디스크 유형 목록입니다. |
GalleryImageFeature
갤러리 이미지에 대한 기능입니다.
Name | 형식 | Description |
---|---|---|
name |
string |
갤러리 이미지 기능의 이름입니다. |
value |
string |
갤러리 이미지 기능의 값입니다. |
GalleryImageIdentifier
갤러리 이미지 정의 식별자입니다.
Name | 형식 | Description |
---|---|---|
offer |
string |
갤러리 이미지 정의 제안의 이름입니다. |
publisher |
string |
갤러리 이미지 정의 게시자의 이름입니다. |
sku |
string |
갤러리 이미지 정의 SKU의 이름입니다. |
HyperVGeneration
가상 머신의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다.
Name | 형식 | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImagePurchasePlan
갤러리 이미지 정의 구매 계획에 대해 설명합니다. 이는 마켓플레이스 이미지에서 사용됩니다.
Name | 형식 | Description |
---|---|---|
name |
string |
계획 ID입니다. |
product |
string |
제품 ID입니다. |
publisher |
string |
게시자 ID입니다. |
InnerError
내부 오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
errordetail |
string |
내부 오류 메시지 또는 예외 덤프입니다. |
exceptiontype |
string |
예외 형식입니다. |
OperatingSystemStateTypes
이 속성을 사용하면 사용자가 이 이미지에서 만든 가상 머신이 '일반화됨' 또는 '특수화됨'인지 여부를 지정할 수 있습니다.
Name | 형식 | Description |
---|---|---|
Generalized |
string |
|
Specialized |
string |
OperatingSystemTypes
이 속성을 사용하면 관리되는 이미지에서 VM을 만들 때 디스크에 포함된 OS 유형을 지정할 수 있습니다. 가능한 값은 Windows,Linux입니다.
Name | 형식 | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
RecommendedMachineConfiguration
속성은 이 이미지 정의에 권장되는 컴퓨터 구성을 설명합니다. 이러한 속성은 업다이블할 수 있습니다.
Name | 형식 | Description |
---|---|---|
memory |
리소스 범위를 설명합니다. |
|
vCPUs |
리소스 범위를 설명합니다. |
ResourceRange
리소스 범위를 설명합니다.
Name | 형식 | Description |
---|---|---|
max |
integer |
리소스의 최대 수입니다. |
min |
integer |
리소스의 최소 수입니다. |
SharedGalleryImage
만들거나 업데이트하려는 갤러리 이미지 정의에 대한 정보를 지정합니다.
Name | 형식 | Description |
---|---|---|
identifier.uniqueId |
string |
이 공유 갤러리의 고유 ID입니다. |
location |
string |
리소스 위치 |
name |
string |
리소스 이름 |
properties.architecture |
이미지의 아키텍처입니다. OS 디스크에만 적용됩니다. |
|
properties.artifactTags |
object |
공유 갤러리 리소스의 아티팩트 태그입니다. |
properties.disallowed |
허용되지 않는 디스크 유형에 대해 설명합니다. |
|
properties.endOfLifeDate |
string |
갤러리 이미지 정의의 수명 종료 날짜입니다. 이 속성은 서비스 해제 목적으로 사용할 수 있습니다. 이 속성은 업데이트할 수 있습니다. |
properties.eula |
string |
현재 커뮤니티 갤러리 이미지에 대한 최종 사용자 사용권 계약입니다. |
properties.features |
갤러리 이미지 기능 목록입니다. |
|
properties.hyperVGeneration |
가상 머신의 하이퍼바이저 생성입니다. OS 디스크에만 적용됩니다. |
|
properties.identifier |
갤러리 이미지 정의 식별자입니다. |
|
properties.osState |
이 속성을 사용하면 사용자가 이 이미지에서 만든 가상 머신이 '일반화됨' 또는 '특수화됨'인지 여부를 지정할 수 있습니다. |
|
properties.osType |
이 속성을 사용하면 관리되는 이미지에서 VM을 만들 때 디스크에 포함된 OS 유형을 지정할 수 있습니다. 가능한 값은 Windows,Linux입니다. |
|
properties.privacyStatementUri |
string |
현재 커뮤니티 갤러리 이미지에 대한 개인 정보 취급 방침 URI입니다. |
properties.purchasePlan |
갤러리 이미지 정의 구매 계획에 대해 설명합니다. 이는 마켓플레이스 이미지에서 사용됩니다. |
|
properties.recommended |
속성은 이 이미지 정의에 권장되는 컴퓨터 구성을 설명합니다. 이러한 속성은 업다이블할 수 있습니다. |