銷售: 1-800-867-1380

加入資料磁碟

更新日期: 2014年4月

Add Data Disk 作業會將資料磁碟加入至虛擬機器。

Add Data Disk request is specified as follows.請以您的訂用帳戶 ID 取代 <subscription-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

可能的值為:



  • 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

唯一識別對管理服務發出之要求的值。若為非同步作業,您可以使用標頭的值來呼叫 Get Operation Status,以便判斷作業已完成、失敗,還是仍在進行中。如需詳細資訊,請參閱<追蹤非同步服務管理要求>。

無。

只有帳戶擁有者可呼叫這項作業。

使用 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