匯出 (0) 列印
全部展開

列出磁碟

更新日期: 2014年4月

List Disks 作業會擷取映像儲存機制中的磁碟清單。

List Disks 要求的指定方式如下。請以您的訂用帳戶 ID 取代 <subscription-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

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

回應主體的格式如下:

  
<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

磁碟所連接的虛擬機器。

作業系統

作業系統映像的作業系統類型。

可能的值為:

  • 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

從中建立磁碟的作業系統映像名稱。當您透過呼叫 Add Role、Create Deployment 或 Provision Disk 作業,從作業系統映像建立磁碟時,就會自動填入這個屬性。

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

顯示:
© 2014 Microsoft