영업: 1-800-867-1380

데이터 디스크 추가

업데이트 날짜: 2014년 4월

Add Data Disk 작업은 가상 컴퓨터에 데이터 디스크를 추가합니다.

다음과 같이 Add Data Disk 요청을 지정합니다. <subscription-id>를 구독 ID로 바꾸고, <service-name>을 서비스 이름으로 바꾸고, <deployment-name>을 배포 이름으로 바꾸고, <role-name>을 데이터 디스크를 추가할 역할의 이름으로 바꾸십시오.

 

메서드 요청 URI HTTP 버전

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<service-name>/deployments/<deployment-name>/roles/<role-name>/DataDisks

HTTP/1.1

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

 

요청 헤더 설명

x-ms-version

필수 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 현재 이 헤더는 2012-03-01로 설정되어야 합니다.

요청 본문의 형식은 다음과 같습니다.


<DataVirtualHardDisk xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <HostCaching>ReadOnly|ReadWrite</HostCaching>
  <DiskLabel>new-name-for-disk-disk</DiskLabel>
  <DiskName>name-of-disk-in-image-repository</DiskName> 
  <Lun>0-to-15</Lun>
  <LogicalDiskSizeInGB>size-in-gb-of-the-data-data-disk</LogicalDiskSizeInGB>
  <MediaLink>uri-of-the-blob</MediaLink>
  <SourceMediaLink>uri-of-the-blob</SourceMediaLink>
</DataVirtualHardDisk>

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

 

요소 이름 설명

HostCaching

필수 사항입니다. 읽기/쓰기 효율성에 대한 데이터 디스크 Blob의 플랫폼 캐싱 동작을 지정합니다. 기본값은 ReadOnly입니다.

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

  • None

  • ReadOnly

  • ReadWrite

Warning경고
이 속성을 설정하면 디스크 일관성에 영향을 주게 됩니다.

DiskLabel

선택 사항입니다. 데이터 디스크에 대한 설명을 지정합니다. MediaLink 요소를 사용하여 미디어를 직접 참조하거나 대상 디스크 크기를 지정하여 디스크를 연결할 때 DiskLabel 요소를 사용하여 대상 데이터 디스크의 이름 속성을 사용자 지정할 수 있습니다.

DiskName

선택 사항입니다. 디스크의 이름을 지정합니다. Windows Azure는 지정된 디스크를 사용하여 컴퓨터에 대한 데이터 디스크를 만들고 이 필드를 디스크 이름으로 채웁니다.

Lun

선택 사항입니다. 디스크의 LUN(논리 단위 번호)을 지정합니다. LUN은 가상 컴퓨터에서 사용할 수 있도록 장착할 때 데이터 드라이브가 나타나는 슬롯을 지정합니다.

유효한 LUN 값은 0에서 15까지입니다.

LogicalDiskSizeInGB

선택 사항입니다. 역할에 연결할 빈 디스크의 크기(GB)를 지정합니다. 디스크 연결 중에 디스크를 만들거나, 이 속성의 값을 지정하여 VM 역할 호출을 만들 수 있습니다.

Windows Azure에서는 크기 기본 설정에 따라 빈 디스크를 만든 다음 새로 만든 디스크를 역할에 연결합니다.

MediaLink

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

예:

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

SourceMediaLink

선택 사항입니다. 가상 컴퓨터가 만들어질 때 데이터 디스크로 마운트된 계정 저장소에서의 Blob의 위치를 지정합니다.

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

작업이 성공하면 상태 코드 201(만들어짐)이 반환됩니다. 상태 코드에 대한 자세한 내용은 서비스 관리 상태 및 오류 코드를 참조하십시오.

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

 

응답 헤더 설명

x-ms-request-id

관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다. 비동기 작업의 경우 헤더 값과 함께 작업 상태 가져오기를 호출하여 작업이 완료되었는지, 실패했는지, 계속 진행 중인지 여부를 확인할 수 있습니다. 자세한 내용은 비동기 서비스 관리 요청 추적을 참조하십시오.

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

다음 3가지 방법으로 Add Data Disk 작업을 사용하여 데이터 디스크를 만들 수 있습니다.

옵션 1 – 디스크 이미지의 디스크 레이블 및 위치를 지정하여 역할에 빈 데이터 디스크를 연결합니다.

  • 요청 본문에 DiskName 및 SourceMediaLink 요소를 포함하지 마십시오.

  • MediaLink 요소를 포함하고 역할과 동일한 지역에 있는 Blob을 참조합니다.

  • MediaLink 요소를 생략할 수도 있습니다. 이 사용법에서 Windows Azure는 역할에 대한 기본값으로 구성된 저장소 계정에서 데이터 디스크를 만듭니다.

옵션 2 – 이미지 리포지토리에 있는 기존 데이터 디스크를 연결합니다.

  • 요청 본문에 DiskName 및 SourceMediaLink 요소를 포함하지 마십시오.

  • DiskName 요소를 포함하여 사용할 데이터 디스크를 지정합니다.

note참고
응답 본문에 포함된 경우 MediaLink 및 LogicalDiskSizeInGB 요소가 무시됩니다.

옵션 3 - 사용할 디스크 이미지를 포함하는 저장소 계정에서의 Blob 위치를 지정합니다.

  • SourceMediaLink 요소를 포함합니다.

note참고
MediaLink 요소가 포함된 경우 무시됩니다.

이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.
표시:
© 2014 Microsoft