OS 이미지 나열

OS 이미지 나열

 

List OS Images 작업은 지정된 구독에 연결된 이미지 리포지토리에서 운영 체제 이미지 목록을 검색합니다.

다음과 같이 List OS Images 요청을 지정할 수 있습니다. <subscription-id>를 구독 ID로 바꾸십시오.

방법

요청 URI

GET

https://management.core.windows.net/<subscription-id>/services/images

관리 서비스에 대한 요청이 안전한지 확인해야 합니다. 자세한 내용은 1becb7dc-1cdc-4db4-8ae8-7e351c96c251을 참조하세요.

다음 표에서는 요청 헤더에 대해 설명합니다.

요청 헤더

설명

x-ms-version

필수 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더는 01.03.13 이후로 설정되어야 합니다. 버전 관리 헤더에 대한 자세한 내용은 서비스 관리 버전 관리를 참조하세요.

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.

작업에 성공하면 상태 코드 200(정상)이 반환됩니다. 상태 코드에 대한 자세한 내용은 10f8d244-4649-4063-b6c9-7a20765513fa를 참조하세요.

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

응답 헤더

설명

x-ms-request-id

관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다.

응답 본문의 형식은 다음과 같습니다.


<Images xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <OSImage>
    <AffinityGroup>name-of-the-affinity-group</AffinityGroup>
    <Category>category-of-the-image</Category>
    <Label>image-description</Label>
    <Location>geo-location-of-the-stored-image</Location>
    <LogicalSizeInGB>size-of-the-image</LogicalSizeInGB>
    <MediaLink>url-of-the-containing-blob</MediaLink>
    <Name>image-name</Name>
    <OS>operating-system-of-the-image</OS>
    <Eula>image-eula</Eula>
    <Description>image-description</Description>
    <ImageFamily>image-family</ImageFamily>
    <ShowInGui>indicator-of-availability</ShowInGui>
    <PublishedDate>published-date</PublishedDate>
    <IsPremium>indicator-of-image-status</IsPremium>
    <PrivacyUri>uri-of-privacy-policy</PrivacyUri>
    <RecommendedVMSize>size-of-the-virtual-machine</RecommendedVMSize>
    <PublisherName>publisher-identifier</PublisherName>
    <PricingDetailLink>pricing-details</PricingDetailLink>
    <SmallIconUri>uri-of-icon</SmallIconUri>
    <Language>language-of-image</Language>
    <IOType>IO-Type<IOType>
  </OSImage>
</Images>

다음 표에서는 응답 본문의 요소에 대해 설명합니다.

요소 이름

설명

AffinityGroup

이 미디어가 있는 선호도를 지정합니다. AffinityGroup 값은 미디어가 있는 Blob이 포함된 저장소 계정에서 파생됩니다. 저장소 계정이 선호도 그룹에 속하지 않는 경우 값은 NULL이며 응답에 요소가 표시되지 않습니다.

플랫폼 이미지의 경우 이 값은 NULL입니다.

범주

이미지의 리포지토리 분류를 지정합니다. 모든 사용자 이미지는 User 범주가 있습니다. 버전이 2013-10-01 이상으로 설정되었으면 다음과 같은 값도 사용할 수 있습니다.

  • Public – 모두에 적용되는 플랫폼 이미지입니다.

  • Private – 비공개로 사용할 수 있는 플랫폼 이미지입니다.

  • MSDN - MSDN을 통해 제공되는 플랫폼 이미지입니다.

Label

이미지의 식별자를 지정합니다.

위치

이 미디어가 있는 지리적 위치입니다. Location 값은 미디어가 있는 Blob이 포함된 저장소 계정에서 파생됩니다. 저장소 계정이 선호도 그룹에 속한 경우 이 값은 NULL입니다.

버전이 2012-08-01 이후로 설정된 경우 플랫폼 이미지에 대한 위치가 반환됩니다. 그렇지 않으면 이 값은 플랫폼 이미지에 대해 NULL입니다.

LogicalSizeInGB

이미지의 크기(GB)를 지정합니다.

MediaLink

이미지의 VHD 파일 위치를 지정합니다. VHD가 있는 저장소 계정이 지정된 구독과 연결되어 있어야 합니다.

예:

http://example.blob.core.windows.net/disks/myimage.vhd

Name

운영 체제 이미지의 이름을 지정합니다. 이는 이미지를 사용하여 하나 이상의 가상 컴퓨터를 만들 때 사용되는 이름입니다.

OS

이미지의 운영 체제 유형을 지정합니다.

가능한 값은 아래와 같습니다.

  • Linux

  • Windows

Eula

이미지에 연결된 EULA(최종 사용자 사용권 계약)를 지정합니다. 이 요소의 값은 문자열이지만 EULA를 가리키는 URL을 지정하는 것이 좋습니다.

설명

이미지에 대한 설명을 지정합니다.

ImageFamily

이미지를 그룹화하는 데 사용할 수 있는 값을 지정합니다.

PublishedDate

이미지가 이미지 리포지토리에 추가된 날짜를 지정합니다.

IsPremium

이미지에 가상 컴퓨터에 대한 주요 가격 이상의 요금을 부과할 소프트웨어 또는 관련 서비스가 포함되어 있는지 여부를 나타냅니다. 자세한 내용은 PricingDetailLink 요소를 참조하세요.

PrivacyUri

이미지와 관련된 개인 정보 취급 방침이 포함된 문서를 가리키는 URI를 지정합니다.

RecommendedVMSize

이미지에서 만든 가상 컴퓨터에 사용할 크기를 지정합니다.

PublisherName

이미지의 게시자 이름입니다. 모든 사용자 이미지는 User라는 게시자 이름을 가집니다.

PricingDetailLink

IsPremiumtrue로 설정된 이미지에 대한 URL을 지정합니다. 이 URL에는 이미지에서 만든 가상 컴퓨터에 대한 가격 정보가 포함되어 있습니다.

PricingDetailLink 요소는 버전 01.12.12 이후인 경우에만 사용할 수 있습니다.

SmallIconUri

Microsoft Azure 관리 포털에서 이미지가 제공될 때 표시되는 작은 아이콘의 URI를 지정합니다.

SmallIconUri 요소는 버전 01.03.13 이후인 경우에만 사용할 수 있습니다.

언어

이미지의 언어를 지정합니다.

Language 요소는 버전 01.03.13 이후인 경우에만 사용할 수 있습니다.

IOType

이 속성은 백업 VHD용 저장소 계정의 형식을 식별합니다.

백업 VHD가 프로비저닝된 저장소 계정에 있으면 "프로비전됨"이 반환되고 그렇지 않으면 "표준"이 반환됩니다.

참고: 이 값은 사용자가 입력하는 것이 아니라 디스크를 만들 때 Azure 플랫폼에서 입력합니다.

이 속성은 2014-10-01 이상의 버전 헤더로만 반환됩니다.

표시:
© 2016 Microsoft