Elencare i dischi

 

L'operazione List Disks recupera un elenco dei dischi nell'archivio immagini associato alla sottoscrizione specificata.

La richiesta di List Disks può essere specificata come indicato di seguito. Sostituire <subscription-id> con l'ID sottoscrizione.

Metodo

URI richiesta

GET

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

È necessario verificare che la richiesta effettuata al servizio di gestione sia sicura. Per altri dettagli, vedere 1becb7dc-1cdc-4db4-8ae8-7e351c96c251.

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta

Descrizione

x-ms-version

Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su 2014-10-01 o una versione successiva. Per altre informazioni sulle intestazioni di controllo delle versioni, vedere Controllo delle versioni relativo alla gestione dei servizi.

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Un'operazione completata correttamente restituisce il codice di stato 200 (OK). Per informazioni sui codici di stato, vedere 10f8d244-4649-4063-b6c9-7a20765513fa.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Intestazione della risposta

Descrizione

x-ms-request-id

Valore che identifica in modo univoco una richiesta effettuata nel servizio di gestione.

Il formato del corpo della risposta è il seguente:


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

Nella tabella indicata di seguito vengono descritti gli elementi del corpo della risposta.

Nome elemento

Descrizione

AffinityGroup

Specifica il gruppo di affinità in cui si trova il disco. Il valore AffinityGroup è derivato dall'account di archiviazione che contiene il BLOB in cui si trova il VHD. Se l'account di archiviazione non appartiene a un gruppo di affinità il valore è NULL.

AttachedTo

Specifica informazioni sulla macchina virtuale che sta utilizzando attualmente il disco. Un disco non può essere eliminato se è collegato a una macchina virtuale.

HostedServiceName

Specifica il servizio cloud in cui viene utilizzato il disco.

DeploymentName

Specifica la distribuzione in cui viene utilizzato il disco.

RoleName

Specifica la macchina virtuale a cui è collegato il disco.

Sistema operativo

Tipo di sistema operativo dell'immagine nel disco.

I valori possibili sono:

  • Linux

  • Windows

  • NULL

Location

Specifica la posizione geografica in cui si trova il disco. Il valore Location viene derivato dall'account di archiviazione che contiene il BLOB in cui si trova il disco. Se l'account di archiviazione appartiene a un gruppo di affinità il valore è NULL.

LogicalSizeInGB

Specifica le dimensioni del disco, espresse in GB.

MediaLink

Specifica il percorso del BLOB nell'archivio BLOB in cui si trovano i supporti per il disco. La posizione del BLOB appartiene all'account di archiviazione della sottoscrizione specificata dal valore <subscription-id> nella chiamata all'operazione.

Esempio:

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

Nome

Specifica il nome del disco. È il nome utilizzato quando si crea una macchina virtuale che utilizza il disco.

SourceImageName

Specifica il nome dell'immagine di sistema operativo da cui è stato creato il disco. Questa proprietà viene popolata automaticamente quando viene creato un disco da un'immagine di sistema operativo chiamando l'operazione Add Role o Create Virtual Machine Deployment.

CreatedTime

Specifica nel formato UTC quando è stato creato il disco.

L'elemento CreatedTime è disponibile solo se si usa la versione 2014-01-01 o una versione successiva.

IOType

Questa proprietà identifica il tipo dell'account di archiviazione per il disco VHD di supporto.

Se il disco VHD si trova in un account di archiviazione sottoposto a provisioning, viene restituito "Provisioned", in caso contrario viene restituito "Standard".

Nota: questo valore viene popolato dalla piattaforma Azure, non dall'utente, quando viene creato il disco.

Questa proprietà viene restituita solo con un'intestazione di versione 2014-10-01 o versione successiva.

Mostra: