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

디스크 나열

업데이트 날짜: 2014년 4월

List Disks 작업은 이미지 리포지토리에 있는 디스크 목록을 검색합니다.

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

 

메서드 요청 URI HTTP 버전

GET

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

HTTP/1.1

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

 

요청 헤더 설명

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>affinity-group-name</AffinityGroup>
    <AttachedTo>
      <HostedServiceName>hostedService-name</HostedServiceName>
      <DeploymentName>deployment-name</DeploymentName> 
      <RoleName>role-name</RoleName>
    </AttachedTo>
    <OS>Linux|Windows</OS>
    <Location>geo-location-of-the-stored-disk</Location>
    <LogicalSizeInGB>size-of-the-disk</LogicalSizeInGB>
    <MediaLink>uri-of-the-containing-blob</MediaLink>
    <Name>disk-name</Name>
    <SourceImageName>source-image-name</SourceImageName>
  </Disk>
  ...
</Disks>

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

 

요소 이름 설명

AffinityGroup

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

AttachedTo

현재 디스크를 사용 중인 가상 컴퓨터를 지정하는 속성을 포함합니다. 디스크가 가상 컴퓨터에 연결되어 있으면 디스크를 삭제할 수 없습니다.

HostedServiceName

디스크를 사용 중인 호스팅 서비스입니다.

DeploymentName

디스크를 사용 중인 배포입니다.

RoleName

디스크가 연결되어 있는 가상 컴퓨터입니다.

OS

OS 이미지의 운영 체제 유형입니다.

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

  • Linux

  • Windows

  • NULL

Location

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

LogicalSizeInGB

디스크의 크기(GB)입니다.

MediaLink

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

예:

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

Name

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

SourceImageName

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

계정 소유자만 이 작업을 호출할 수 있습니다.

표시:
© 2014 Microsoft