내보내기(0) 인쇄
모두 확장

디스크 나열

업데이트 날짜: 2015년 4월

List Disks 작업은 지정된 구독에 연결된 이미지 리포지토리에서 디스크 목록을 검색합니다.

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

 

방법 요청 URI

GET

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

관리 서비스에 대한 요청이 안전한지 확인해야 합니다. 자세한 내용은 서비스 관리 요청 인증을 참조하세요.

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

 

요청 헤더 설명

x-ms-version

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

없음.

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

작업에 성공하면 상태 코드 200(정상)이 반환됩니다. 상태 코드에 대한 자세한 내용은 서비스 관리 상태 및 오류 코드를 참조하세요.

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

 

응답 헤더 설명

x-ms-request-id

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

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

  
<Disks xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Disk>
    <AffinityGroup>name-of-affinity-group</AffinityGroup>
    <AttachedTo>
      <HostedServiceName>name-of-cloud-service</HostedServiceName>
      <DeploymentName>name-of-deployment</DeploymentName> 
      <RoleName>name-of-virtual-machine</RoleName>
    </AttachedTo>
    <OS>operating-system-type</OS>
    <Location>geo-location-of-disk</Location>
    <LogicalSizeInGB>size-of-disk</LogicalSizeInGB>
    <MediaLink>uri-of-vhd</MediaLink>
    <Name>name-of-disk</Name>
    <SourceImageName>name-of-source-image</SourceImageName>
    <CreatedTime>creation-time-of-disk</CreatedTime>
    <IOType>IO-Type<IOType>
  </Disk>
</Disks>

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

 

요소 이름 설명

AffinityGroup

이 디스크가 있는 선호도 그룹을 지정합니다. AffinityGroup 값은 VHD가 있는 Blob이 포함된 저장소 계정에서 파생됩니다. 저장소 계정이 선호도 그룹에 속하지 않은 경우 이 값은 NULL입니다.

AttachedTo

현재 디스크를 사용하고 있는 가상 컴퓨터에 대한 정보를 지정합니다. 디스크가 가상 컴퓨터에 연결되어 있으면 디스크를 삭제할 수 없습니다.

HostedServiceName

디스크를 사용 중인 클라우드 서비스를 지정합니다.

DeploymentName

디스크를 사용 중인 배포를 지정합니다.

RoleName

디스크가 연결되어 있는 가상 컴퓨터를 지정합니다.

OS

디스크에 있는 이미지의 운영 체제 유형입니다.

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

  • Linux

  • Windows

  • NULL

위치

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

LogicalSizeInGB

디스크의 크기(GB)를 지정합니다.

MediaLink

Blob 저장소에서 디스크 미디어가 있는 Blob의 위치를 지정합니다. Blob 위치는 작업 호출에서 <subscription-id> 값으로 지정된 구독의 저장소 계정에 속합니다.

예:

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

Name

디스크의 이름을 지정합니다. 디스크를 사용하여 가상 컴퓨터를 만들 때 사용되는 이름입니다.

SourceImageName

디스크를 만들 때 사용된 OS 이미지의 이름을 지정합니다. 역할 추가 또는 가상 컴퓨터 배포 만들기 작업을 호출하여 OS 이미지에서 디스크를 만들 때 이 속성이 자동으로 채워집니다.

CreatedTime

디스크를 만든 시간을 UTC 형식으로 지정합니다.

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

IOType

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

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

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

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

표시:
© 2015 Microsoft