Exportar (0) Imprimir
Expandir todo

Obtener propiedades de la cuenta de almacenamiento

Actualizado: octubre de 2014

La operación Get Storage Account Properties devuelve las propiedades del sistema para la cuenta de almacenamiento especificada.

La solicitud Get Storage Account Properties se puede especificar como sigue. Reemplace <subscription-id> por el identificador de la suscripción y <storage-account-name> por el nombre de la cuenta de almacenamiento.

 

Método URI de solicitud

GET

https://management.core.windows.net/<subscription-id>/services/storageservices/<storage-account-name>

Debe asegurarse de que la solicitud que se realice al servicio de administración sea segura. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

Ninguna.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

x-ms-version

Requerido. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debería establecerse en 01/10/2009 o posterior. Para obtener más información acerca de los encabezados de control de versiones, vea Control de versiones de la administración del servicio.

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.

El formato del cuerpo de respuesta es el siguiente:


<?xml version="1.0" encoding="utf-8"?>
<StorageService xmlns="http://schemas.microsoft.com/windowsazure">
  <Url>storage-account-request-uri</Url>
  <ServiceName>storage-account-name</ServiceName>
  <StorageServiceProperties>
    <Description>description</Description>
    <AffinityGroup>affinity-group</AffinityGroup>
    <Location>location</Location>
    <Label>base64-encoded-label</Label>  
    <Status>status</Status>
    <Endpoints>
      <Endpoint>storage-service-blob-endpoint</Endpoint>
      <Endpoint>storage-service-queue-endpoint</Endpoint>
      <Endpoint>storage-service-table-endpoint</Endpoint>
      <Endpoint>storage-service-file-endpoint</Endpoint>
    </Endpoints>
    <GeoReplicationEnabled>geo-replication-indicator</GeoReplicationEnabled>
    <GeoPrimaryRegion>primary-region</GeoPrimaryRegion> 
    <StatusOfPrimary>primary-status</StatusOfPrimary>
    <LastGeoFailoverTime>DateTime</LastGeoFailoverTime>  
    <GeoSecondaryRegion>secondary-region</GeoSecondaryRegion>  
    <StatusOfSecondary>secondary-status</StatusOfSecondary>
    <CreationTime>time-of-creation</CreationTime>
    <CustomDomains>
      <CustomDomain>
        <Name>name-of-custom-domain</Name>
      </CustomDomain>
    </CustomDomains>
    <SecondaryReadEnabled>secondary-read-indicator</SecondaryReadEnabled>
    <SecondaryEndpoints>
      <Endpoint>storage-secondary-service-blob-endpoint</Endpoint>
      <Endpoint>storage-secondary-service-queue-endpoint</Endpoint>
      <Endpoint>storage-secondary-service-table-endpoint</Endpoint>
    </SecondaryEndpoints>
    <AccountType>type-of-storage-account</AccountType>
  </StorageServiceProperties>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>property-name</Name>
      <Value>property-value</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <Capabilities>
    <Capability>storage-account-capability</Capability>
  </Capabilities>
</StorageService>

En la tabla siguiente se describen los elementos del cuerpo de respuesta.

 

Nombre del elemento Descripción

Dirección URL

Especifica el URI de la cuenta de almacenamiento.

ServiceName

Especifica el nombre de la cuenta de almacenamiento. Este nombre es el nombre del prefijo DNS y se puede utilizar para obtener acceso a blobs, colas y las tablas de la cuenta de almacenamiento.

Por ejemplo, si el nombre de servicio es MyStorageAccount puede acceder a los contenedores de blobs llamando a: http://MyStorageAccount.blob.core.windows.net/mycontainer/

StorageServiceProperties

Especifica las propiedades de la cuenta de almacenamiento.

ExtendedProperties

Especifica el nombre y el valor de una propiedad extendida que se agregó a la cuenta de almacenamiento.

Capacidad

Indica si la cuenta de almacenamiento puede realizar operaciones relacionadas con la máquina virtual. En tal caso, este elemento devuelve una cadena que contiene PersistentVMRole. De lo contrario, este elemento no estará presente.

El elemento Capability solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

Especifica las propiedades de la cuenta de almacenamiento.

 

Nombre del elemento Descripción

Descripción

Opcional. Descripción de la cuenta de almacenamiento. La descripción puede tener hasta 1024 caracteres.

El elemento Description solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

AffinityGroup

Es necesario si Location no se especifica. Nombre de un grupo de afinidad existente asociado a la suscripción. Este nombre es un GUID y se puede recuperar examinando el elemento nombre del cuerpo de la respuesta que devuelve la operación Enumerar grupos de afinidad.

El elemento AffinityGroup solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

Ubicación

Es necesario si AffinityGroup no se especifica. Ubicación donde se creará la cuenta de almacenamiento.

El elemento Location solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

Etiqueta

Requerido. Nombre del servicio hospedado que está codificado en base 64. El nombre puede tener hasta 100 caracteres. El nombre se puede utilizar para identificar la cuenta de almacenamiento con fines de seguimiento.

El elemento Label solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

Estado

Estado de la cuenta de almacenamiento. Los valores posibles son:

  • Creating

  • Created

  • Deleting

  • Deleted

  • Changing

  • ResolvingDns

El elemento Status solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

Extremos

Especifica el blob, la tabla, la cola y los extremos de archivos para la cuenta de almacenamiento.

noteNota
Para el tipo de cuenta ZRS estándar, se devuelve solo el extremo del blob. Además, ZRS solo admite blobs en bloques, no blobs de página y, por tanto, no es compatible con las máquinas virtuales.

GeoReplicationEnabled

Indica si los datos de la cuenta de almacenamiento están replicados en más de una ubicación geográfica para habilitar resistencia frente a la pérdida de servicios catastrófica. El valor es true si la replicación geográfica está habilitada; de lo contrario false.

El elemento GeoReplicationEnabled solo está disponible con la versión del 01/03/2012 o posterior y se reemplaza por el elemento AccountType con la versión del 01/06/2014 o posterior.

GeoPrimaryRegion

Indica la región geográfica primaria en la que la cuenta de almacenamiento existe en este momento.

El elemento GeoPrimaryRegion solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

StatusOfPrimary

Indica si la región de almacenamiento primaria está disponible.

Los valores posibles son:

  • Available

  • Unavailable

El elemento StatusOfPrimary solamente se encuentra disponible si utiliza la versión 01/11/2013 o versiones posteriores.

LastGeoFailoverTime

Marca de tiempo que indica la instancia más reciente de una conmutación por error a la región secundaria. En caso de conmutaciones por error múltiples solo la última fecha y hora de conmutación por error se mantiene.

El formato de marca de tiempo devuelto es: [4DigitYear]/[2DigitMonth]-[2DigitDay]T[2DigitMinute]:[2DigitSecond]:[7DigitsOfPrecision]Z

Por ejemplo: <LastGeoFailoverTime>2010-01-18T13:15:30.0000000Z</LastGeoFailoverTime>

LastGeoFailoverTime no se devuelve si no se ha producido una instancia de una conmutación por error.

El elemento LastGeoFailoverTime solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

GeoSecondaryRegion

Indica la región geográfica en la que la cuenta de almacenamiento se está replicando.

El elemento GeoSecondaryRegion no se devuelve si la replicación geográfica está "desactivada" para esta cuenta.

El elemento GeoSecondaryRegion solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

StatusOfSecondary

Indica si la región de almacenamiento secundaria está disponible.

Los valores posibles son:

  • Available

  • Unavailable

El elemento StatusOfSecondary solamente se encuentra disponible si utiliza la versión 01/11/2013 o versiones posteriores.

CreationTime

Especifica la hora a la que se creó la cuenta de almacenamiento.

CustomDomains

Especifica los dominios personalizados asociados a la cuenta de almacenamiento.

El elemento CustomDomains solamente se encuentra disponible si utiliza la versión 01/06/2013 o versiones posteriores.

SecondaryReadEnabled

Indica que la lectura secundaria está habilitada para la cuenta de almacenamiento.

Los valores posibles son:

  • true

  • false

El elemento SecondaryReadEnabled solo está disponible con la versión del 01/11/2013 o posterior y se reemplaza por el elemento AccountType con la versión del 01/06/2014 o posterior.

SecondaryEndpoints

Especifica los extremos secundarios de la cuenta de almacenamiento.

El elemento SecondaryEndpoints solamente se encuentra disponible si utiliza la versión 01/11/2013 o versiones posteriores.

AccountType

Especifica si la cuenta admite almacenamiento con redundancia local, almacenamiento con redundancia geográfica, almacenamiento con redundancia de zona o almacenamiento con redundancia geográfica con acceso de lectura.

Los valores posibles son:

  • Standard_LRS

  • Standard_ZRS

  • Standard_GRS

  • Standard_RAGRS

El elemento AccountType solo está disponible con la versión del 01/06/2014 o posterior y reemplaza los elementos SecondaryReadEnabled y GeoReplicationEnabled.

Especifica los extremos de la cuenta de almacenamiento.

 

Nombre del elemento Descripción

Extremo

Contiene el extremo del servicio de blobs en el siguiente formato: https:// <storage-service-name>.blob.core.windows.net

El elemento Endpoint solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores. Extremos HTTP, se devuelven con la versión del 01/04/2014 o versiones inferiores.

Extremo

Contiene el extremo de la cola del servicio de blobs en el siguiente formato: https:// <storage-service-name>.queue.core.windows.net

El elemento Endpoint solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores. Extremos HTTP, se devuelven con la versión del 01/04/2014 o versiones inferiores.

Extremo

Contiene el extremo del servicio de tablas en el siguiente formato: https://<storage-service-name>.table.core.windows.net

El elemento Endpoint solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores. Extremos HTTP, se devuelven con la versión del 01/04/2014 o versiones inferiores.

Extremo

Contiene el extremo del servicio de archivos en el siguiente formato: https://<storage-service-name>.file.core.windows.net

El elemento Endpoint solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores. Extremos HTTP, se devuelven con la versión del 01/04/2014 o versiones inferiores.

Especifica los dominios personalizados asociados a la cuenta de almacenamiento.

 

Nombre del elemento Descripción

CustomDomain

Especifica la información sobre un dominio personalizado asociado a la cuenta de almacenamiento.

Nombre

Especifica el nombre del dominio personalizado.

Especifica los extremos secundarios de la cuenta de almacenamiento.

 

Nombre del elemento Descripción

Extremo

Contiene el extremo del servicio secundario de blobs en el siguiente formato: https://<storage-secondary-service-name>.blob.core.windows.net

Extremos HTTP, se devuelven con la versión del 01/04/2014 o versiones inferiores.

Extremo

Contiene el extremo de la cola del servicio de blobs en el siguiente formato: https://<storage-secondary-service-name>.queue.core.windows.net

Extremos HTTP, se devuelven con la versión del 01/04/2014 o versiones inferiores.

Extremo

Contiene el extremo del servicio de tablas en el siguiente formato: https://<storage-secondary-service-name>.table.core.windows.net

Extremos HTTP, se devuelven con la versión del 01/04/2014 o versiones inferiores.

Especifica el nombre y el valor de una propiedad extendida que se agregó a la cuenta de almacenamiento.

 

Nombre del elemento Descripción

Nombre

Opcional. Representa el nombre de una propiedad de la cuenta de almacenamiento extendida. Cada propiedad extendida debe tener tanto un nombre como un valor definidos. Puede tener un máximo de 50 pares de valores/nombres de propiedad extendidos.

La longitud máxima del elemento Nombre es de 64 caracteres, solo los caracteres alfanuméricos y caracteres de subrayado son válidos en el Nombre y debe comenzar por una letra. Intentar utilizar otros caracteres, empezando el Nombre con un carácter no alfanumérico, o escribir un nombre idéntico al de otra propiedad extendida propiedad de la misma cuenta de almacenamiento, producirá un error de código de estado 400 (solicitud incorrecta).

El elemento Name solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

Valor

Opcional. Representa el valor de una propiedad de la cuenta de almacenamiento extendida. Cada propiedad extendida debe tener tanto un nombre como un valor definidos. Puede tener un máximo de 50 pares de valores/nombres de propiedad extendidos, y cada valor de propiedad extendido tiene una longitud máxima de 255 caracteres.

El elemento Value solamente se encuentra disponible si utiliza la versión 01/03/2012 o versiones posteriores.

La replicación geográfica se puede habilitar cuando se crea o actualiza una cuenta de almacenamiento.

Si la x-ms-version es 01/03/2012 o posterior y el grupo de afinidad se creó en una de las regiones Anywhere US, Anywhere Europe, Anywhere Asia obsoletas, el elemento Location devolverá la ubicación donde esté asignado este grupo de afinidad.

El programa de ejemplo siguiente usa el identificador de la suscripción, una huella digital del certificado de administración asociada, la cadena de versión de la operación y un nombre de cuenta de almacenamiento, e imprime las propiedades de cuenta de almacenamiento devueltas a la consola. Inicializa las variables msVersion, subscriptionId, thumbprint y serviceName con sus propios valores para ejecutar el código de ejemplo.

using System;
using System.Collections.Generic;
using System.Net;
using System.Security.Cryptography.X509Certificates;
using System.Xml;
using System.Xml.Linq;
 
class Program
{
    static void Main(string[] args)
    {
        string msVersion = "2011-12-01";
        string subscriptionId = "subscription-id-guid";
        string thumbprint = "certificate-thumbprint";
        string serviceName = "myexamplestorage1";
        try
        {
            // Obtain the certificate with the specified thumbprint
            X509Certificate2 certificate = GetCertificate(thumbprint);
            GetStorageAccountPropertiesExample(
                subscriptionId, certificate, msVersion, serviceName);
        }
        catch (Exception ex)
        {
            Console.WriteLine("Exception caught in Main:");
            Console.WriteLine(ex.Message);
        }
    }
 
    public static X509Certificate2 GetCertificate(string thumbprint)
    {
        List<StoreLocation> locations = new List<StoreLocation> 
            { StoreLocation.CurrentUser, StoreLocation.LocalMachine };
 
        foreach (var location in locations)
        {
            X509Store store = new X509Store("My", location);
            try
            {
                store.Open(OpenFlags.ReadOnly | OpenFlags.OpenExistingOnly);
                X509Certificate2Collection certificates =
                    store.Certificates.Find(
                        X509FindType.FindByThumbprint,
                        thumbprint, false);
                if (certificates.Count == 1)
                {
                    return certificates[0];
                }
            }
            finally
            {
                store.Close();
            }
        }
 
        throw new ArgumentException(string.Format(
            "A certificate with thumbprint '{0}' could not be located.",
            thumbprint));
    }
 
    public static void GetStorageAccountPropertiesExample(
        string subscriptionId,
        X509Certificate2 certificate,
        string version,
        string serviceName)
    {
        string uriFormat = "https://management.core.windows.net/{0}/services/storageservices/{1}";
        Uri uri = new Uri(String.Format(uriFormat, subscriptionId, serviceName));
 
        HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri);
        request.Method = "GET";
        request.Headers.Add("x-ms-version", version);
        request.ClientCertificates.Add(certificate);
        request.ContentType = "application/xml";
 
        XDocument responseBody = null;
        HttpStatusCode statusCode;
        HttpWebResponse response;
        try
        {
            response = (HttpWebResponse)request.GetResponse();
        }
        catch (WebException ex)
        {
            // GetResponse throws a WebException for 400 and 500 status codes
            response = (HttpWebResponse)ex.Response;
        }
        statusCode = response.StatusCode;
        if (response.ContentLength > 0)
        {
            using (XmlReader reader = XmlReader.Create(response.GetResponseStream()))
            {
                responseBody = XDocument.Load(reader);
            }
        }
        response.Close();
        if (statusCode.Equals(HttpStatusCode.OK))
        {
            XNamespace wa = "http://schemas.microsoft.com/windowsazure";
            XElement storageService = responseBody.Element(wa + "StorageService");
            Console.WriteLine(
                "Storage Account Properties for {0}:{1}{2}",
                serviceName, Environment.NewLine, 
                storageService.ToString(SaveOptions.OmitDuplicateNamespaces));
        }
        else
        {
            Console.WriteLine("Call to GetStorageAccountProperties returned an error:");
            Console.WriteLine("Status Code: {0} ({1}):{2}{3}",
                (int)statusCode, statusCode, Environment.NewLine,
                responseBody.ToString(SaveOptions.OmitDuplicateNamespaces));
        }
        return;
    }
}

Mostrar:
© 2014 Microsoft