列出磁碟

 

List Disks 作業會從指定訂閱所關聯的映像儲存機制中擷取磁碟清單。

請使用下列格式指定 List Disks 要求。以訂用帳戶識別碼取代 <subscription-id>

方法

要求 URI

GET

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

您必須確定對管理服務發出的要求是安全的。如需其他詳細資訊,請參閱1becb7dc-1cdc-4db4-8ae8-7e351c96c251

下表描述必要的和選用的要求標頭。

要求標頭

說明

x-ms-version

必要項。指定用於這個要求的作業版本。此標頭應該設定為 2012/3/1 或更高版本。如需版本設定標頭的詳細資訊,請參閱服務管理版本設定

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

成功的作業會傳回狀態碼 200 (確定)。如需狀態碼的資訊,請參閱<10f8d244-4649-4063-b6c9-7a20765513fa

這項作業的回應包括下列標頭。回應也可能包括其他標準 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

名稱

指定磁碟的名稱。這是使用磁碟建立虛擬機器時所使用的名稱。

SourceImageName

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

CreatedTime

指定建立磁碟時使用的 UTC 格式。

必須使用 2014/1/1 版或更高版本,才能使用 CreatedTime 元素。

IOType

此屬性可識別備份 VHD 的儲存體帳戶類型。

如果備份 VHD 位於已佈建的儲存體帳戶中,則會傳回「已佈建」,否則會傳回「標準」。

注意:此值會在磁碟建立時由 Azure 平台填入,而不是由使用者填入。

只有版本標頭為 2014-10-01 或更新版本,才會傳回這個屬性。

顯示: