Virtual Machine Images - Get
가상 머신 이미지를 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{location}/publishers/{publisherName}/artifacttypes/vmimage/offers/{offer}/skus/{skus}/versions/{version}?api-version=2024-07-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
location
|
path | True |
string |
지원되는 Azure 지역의 이름입니다. |
offer
|
path | True |
string |
유효한 이미지 게시자 제품입니다. |
publisher
|
path | True |
string |
유효한 이미지 게시자입니다. |
skus
|
path | True |
string |
유효한 이미지 SKU입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다. |
version
|
path | True |
string |
유효한 이미지 SKU 버전입니다. |
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
그래 |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
user_impersonation | 사용자 계정 가장 |
예제
Virtual |
Virtual |
VirtualMachineImage_Get_MaximumSet_Gen
샘플 요청
GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/locations/aaaaaa/publishers/aaa/artifacttypes/vmimage/offers/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/skus/aaaaaaaaaaaaaaaaaaaaaaaaaaa/versions/aaaaaaaaaaaaaaaaaaa?api-version=2024-07-01
샘플 응답
{
"properties": {
"plan": {
"publisher": "aaaaaaaaaaaaaaaaaaa",
"name": "aaaaaaaaa",
"product": "aaaaaaaaaaaaaa"
},
"osDiskImage": {
"operatingSystem": "Windows"
},
"dataDiskImages": [
{
"lun": 17
}
],
"automaticOSUpgradeProperties": {
"automaticOSUpgradeSupported": true
},
"hyperVGeneration": "V1",
"disallowed": {
"vmDiskType": "None"
},
"features": [
{
"name": "aaaaaaaaaaaaaaaaaaaaa",
"value": "aaaaaaaaaaaaaaaaaaaa"
}
],
"imageDeprecationStatus": {
"imageState": "ScheduledForDeprecation",
"scheduledDeprecationTime": "2023-01-13T00:00:00+00:00",
"alternativeOption": {
"type": "Offer",
"value": "aaaaaaa"
}
}
},
"name": "aaaaaaaaa",
"location": "aaaaa",
"tags": {
"key6817": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
"extendedLocation": {
"name": "aaaaaaaaaaaaaaaaaaaaa",
"type": "EdgeZone"
},
"id": "aaaaaaaaaaa"
}
VirtualMachineImage_Get_MinimumSet_Gen
샘플 요청
샘플 응답
{
"name": "aaaaaaaaa",
"location": "aaaaa",
"id": "aaaaaaaaaaa"
}
정의
Name | Description |
---|---|
Alternative |
이 이미지가 더 이상 사용되지 않는 경우 게시자가 이 이미지에 대해 지정한 대체 옵션에 대해 설명합니다. |
Alternative |
대체 옵션의 형식을 설명합니다. |
Api |
API 오류입니다. |
Api |
API 오류 기준입니다. |
Architecture |
아키텍처 유형을 지정합니다. |
Automatic |
이미지의 자동 OS 업그레이드 속성에 대해 설명합니다. |
Cloud |
Compute 서비스의 오류 응답입니다. |
Data |
데이터 디스크 이미지 정보를 포함합니다. |
Disallowed |
가상 머신 이미지에 대해 허용되지 않는 구성을 지정합니다. |
Extended |
확장된 위치의 복합 형식입니다. |
Extended |
확장된 위치의 형식입니다. |
Hyper |
HyperVGeneration 형식을 지정합니다. |
Image |
이미지의 이미지 사용 중단 상태 속성을 설명합니다. |
Image |
이미지의 상태를 설명합니다. |
Inner |
내부 오류 세부 정보입니다. |
Operating |
osDiskImage의 운영 체제입니다. |
OSDisk |
os 디스크 이미지 정보를 포함합니다. |
Purchase |
MarketPlace를 통해 타사 아티팩트 구매 컨텍스트를 설정하는 데 사용됩니다. |
Virtual |
Virtual Machine 이미지를 설명합니다. |
Virtual |
이미지에서 지원하는 추가 기능을 지정합니다. |
Vm |
허용되지 않는 VM 디스크 유형입니다. |
AlternativeOption
이 이미지가 더 이상 사용되지 않는 경우 게시자가 이 이미지에 대해 지정한 대체 옵션에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
type |
대체 옵션의 형식을 설명합니다. |
|
value |
string |
게시자가 지정한 대체 옵션 값을 나타냅니다. 유형이 제품일 때의 제품 이름 또는 플랜 유형이 계획일 때의 플랜 이름입니다. |
AlternativeType
대체 옵션의 형식을 설명합니다.
Name | 형식 | Description |
---|---|---|
None |
string |
|
Offer |
string |
|
Plan |
string |
ApiError
API 오류입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드입니다. |
details |
API 오류 세부 정보 |
|
innererror |
API 내부 오류 |
|
message |
string |
오류 메시지입니다. |
target |
string |
특정 오류의 대상입니다. |
ApiErrorBase
API 오류 기준입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 코드입니다. |
message |
string |
오류 메시지입니다. |
target |
string |
특정 오류의 대상입니다. |
ArchitectureTypes
아키텍처 유형을 지정합니다.
Name | 형식 | Description |
---|---|---|
Arm64 |
string |
|
x64 |
string |
AutomaticOSUpgradeProperties
이미지의 자동 OS 업그레이드 속성에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
automaticOSUpgradeSupported |
boolean |
이미지에서 자동 OS 업그레이드가 지원되는지 여부를 지정합니다. |
CloudError
Compute 서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
API 오류입니다. |
DataDiskImage
데이터 디스크 이미지 정보를 포함합니다.
Name | 형식 | Description |
---|---|---|
lun |
integer |
데이터 디스크의 논리적 단위 번호를 지정합니다. 이 값은 VM 내의 데이터 디스크를 식별하는 데 사용되므로 VM에 연결된 각 데이터 디스크에 대해 고유해야 합니다. |
DisallowedConfiguration
가상 머신 이미지에 대해 허용되지 않는 구성을 지정합니다.
Name | 형식 | Description |
---|---|---|
vmDiskType |
허용되지 않는 VM 디스크 유형입니다. |
ExtendedLocation
확장된 위치의 복합 형식입니다.
Name | 형식 | Description |
---|---|---|
name |
string |
확장된 위치의 이름입니다. |
type |
확장된 위치의 형식입니다. |
ExtendedLocationTypes
확장된 위치의 형식입니다.
Name | 형식 | Description |
---|---|---|
EdgeZone |
string |
HyperVGenerationTypes
HyperVGeneration 형식을 지정합니다.
Name | 형식 | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
ImageDeprecationStatus
이미지의 이미지 사용 중단 상태 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
alternativeOption |
이 이미지가 더 이상 사용되지 않는 경우 게시자가 이 이미지에 대해 지정한 대체 옵션에 대해 설명합니다. |
|
imageState |
이미지의 상태를 설명합니다. |
|
scheduledDeprecationTime |
string |
나중에 이 이미지가 더 이상 사용되지 않는 것으로 표시될 시간입니다. 이 예약된 시간은 게시자가 선택합니다. |
ImageState
이미지의 상태를 설명합니다.
Name | 형식 | Description |
---|---|---|
Active |
string |
|
Deprecated |
string |
|
ScheduledForDeprecation |
string |
InnerError
내부 오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
errordetail |
string |
내부 오류 메시지 또는 예외 덤프입니다. |
exceptiontype |
string |
예외 형식입니다. |
OperatingSystemTypes
osDiskImage의 운영 체제입니다.
Name | 형식 | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
OSDiskImage
os 디스크 이미지 정보를 포함합니다.
Name | 형식 | Description |
---|---|---|
operatingSystem |
osDiskImage의 운영 체제입니다. |
PurchasePlan
MarketPlace를 통해 타사 아티팩트 구매 컨텍스트를 설정하는 데 사용됩니다.
Name | 형식 | Description |
---|---|---|
name |
string |
계획 ID입니다. |
product |
string |
마켓플레이스에서 이미지의 곱을 지정합니다. imageReference 요소 아래의 Offer와 동일한 값입니다. |
publisher |
string |
게시자 ID입니다. |
VirtualMachineImage
Virtual Machine 이미지를 설명합니다.
Name | 형식 | Description |
---|---|---|
extendedLocation |
Virtual Machine의 확장된 위치입니다. |
|
id |
string |
리소스 ID |
location |
string |
리소스의 지원되는 Azure 위치입니다. |
name |
string |
리소스의 이름입니다. |
properties.architecture |
아키텍처 유형을 지정합니다. |
|
properties.automaticOSUpgradeProperties |
이미지의 자동 OS 업그레이드 속성에 대해 설명합니다. |
|
properties.dataDiskImages |
데이터 디스크 이미지 정보를 포함합니다. |
|
properties.disallowed |
이미지에서 만든 VirtualMachine에 대해 허용되지 않는 구성을 지정합니다. |
|
properties.features |
이미지에서 지원하는 추가 기능을 지정합니다. |
|
properties.hyperVGeneration |
HyperVGeneration 형식을 지정합니다. |
|
properties.imageDeprecationStatus |
이미지의 이미지 사용 중단 상태 속성을 설명합니다. |
|
properties.osDiskImage |
os 디스크 이미지 정보를 포함합니다. |
|
properties.plan |
MarketPlace를 통해 타사 아티팩트 구매 컨텍스트를 설정하는 데 사용됩니다. |
|
tags |
object |
가상 머신에 할당된 태그를 지정합니다. 태그 사용에 대한 자세한 내용은 태그를 사용하여 Azure 리소스구성을 참조하세요. |
VirtualMachineImageFeature
이미지에서 지원하는 추가 기능을 지정합니다.
Name | 형식 | Description |
---|---|---|
name |
string |
기능의 이름입니다. |
value |
string |
기능에 대한 해당 값입니다. |
VmDiskTypes
허용되지 않는 VM 디스크 유형입니다.
Name | 형식 | Description |
---|---|---|
None |
string |
|
Unmanaged |
string |