Exportar (0) Imprimir
Expandir todo

Enumerar discos

Actualizado: abril de 2014

La operación List Disks recupera una lista de los discos del repositorio de imágenes.

La solicitud List Disks se especifica como sigue. Reemplazar <subscription-id> con el identificador de suscripción:

 

Método URI de solicitud Versión de HTTP

GET

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

HTTP/1.1

Ninguno.

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

 

Encabezado de solicitud Descripción

x-ms-version

Obligatorio. Especifica la versión de la operación que se utiliza para esta solicitud. Actualmente, este encabezado debe establecerse en 2012-03-01.

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Una operación correcta devuelve el código de estado 200 (Correcto). Para obtener información acerca de los códigos de estado, vea Estado y códigos de error de administración del servicio.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

x-ms-request-id

Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración. Para una operación asincrónica, puede llamar a obtener el estado de la operación con el valor del encabezado para determinar si la operación se ha completado, ha generado un error o aún está en curso. Para obtener más información, vea Realizar seguimiento de solicitudes asincrónicas de administración de servicios.

El formato del cuerpo de respuesta es el siguiente:

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

La tabla siguiente describe los elementos clave del cuerpo de la respuesta:

 

Nombre del elemento Descripción

AffinityGroup

Grupo de afinidad en el que se encuentra el disco. El valor de AffinityGroup se deriva de la cuenta de almacenamiento que contiene el blob en el que se encuentran los medios. Si la cuenta de almacenamiento no pertenece a un grupo de afinidad el valor es NULL.

AttachedTo

Contiene propiedades que especifican una máquina virtual que está utilizando actualmente el disco. Un disco no se puede eliminar mientras esté adjunto a una máquina virtual.

HostedServiceName

Servicio hospedado en el que se está utilizando el disco.

DeploymentName

Implementación en la que se está utilizando el disco.

RoleName

Máquina virtual a la que está adjunto el disco.

SO

Tipo de sistema operativo de la imagen del SO.

Los valores posibles son:

  • Linux

  • Windows

  • NULL

Ubicación

Ubicación geográfica en la que se encuentra el disco. El valor de Location se deriva de la cuenta de almacenamiento que contiene el blob en el que se encuentra el disco. Si la cuenta de almacenamiento pertenece a un grupo de afinidad el valor es NULL.

LogicalSizeInGB

Tamaño, en GB, del disco.

MediaLink

Ubicación del blob en el almacén de blobs donde se encuentran ubicados los medios para el disco. La ubicación del blob pertenece a una cuenta de almacenamiento en la suscripción especificada por el valor <subscription-id> en la llamada de la operación.

Ejemplo:

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

Nombre

Nombre del disco. Es el nombre que se utiliza para crear una o varias máquinas virtuales mediante el disco.

SourceImageName

Nombre de la imagen del SO desde la que se creó el disco. Esta propiedad se rellena automáticamente cuando un disco se crea a partir de una imagen del SO llamando a las operaciones Agregar rol, Crear implementación o Aprovisionar el disco.

Solo el propietario de la cuenta puede llamar a esta operación.

Mostrar:
© 2014 Microsoft