Esporta (0) Stampa
Espandi tutto

Get Queue Service Properties

Aggiornamento: dicembre 2013

Tramite l'operazione Get Queue Service Properties si ottengono le proprietà del servizio di accodamento di un account di archiviazione, incluse le proprietà per le regole Analisi archiviazione e CORS (Cross-Origin Resource Sharing, condivisione delle risorse multiorigine).

Per informazioni dettagliate sulle regole CORS e sulla logica di valutazione, vedere Supporto della condivisione delle risorse tra le origini (CORS) per i servizi di archiviazione Azure.

La richiesta di Get Queue Service Properties può essere specificata come indicato di seguito. Si consiglia di utilizzare HTTPS. Sostituire <account-name> con il nome dell'account di archiviazione:

 

Metodo URI della richiesta Versione HTTP

GET

https://<account-name>.queue.core.windows.net/?restype=service&comp=properties

HTTP/1.1

Si noti che l'URI deve sempre includere la barra (/) per separare il nome host dal percorso e dalle parti di una query dell'URI. Nel caso di questa operazione, la parte del percorso dell'URI è vuota.

Nell'URI della richiesta è possibile specificare i parametri aggiuntivi seguenti.

 

Parametro Descrizione

restype=service&comp=properties

Obbligatorio. La combinazione di entrambe le stringhe di query è necessaria per ottenere le proprietà del servizio di archiviazione.

timeout

Facoltativo. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione di timeout per le operazioni del servizio di accodamento.

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

 

Intestazione della richiesta Descrizione

Authorization

Obbligatorio. Specifica lo schema di autenticazione, il nome dell'account di archiviazione e la firma. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

x-ms-version

Obbligatoria per tutte le richieste autenticate. Specifica la versione dell'operazione da utilizzare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

x-ms-client-request-id

Facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'utilizzo di questa intestazione è consigliato per la correlazione tra le attività sul lato client e le richieste ricevute dal server. Per altre informazioni vedere Informazioni sulla registrazione di Analisi archiviazione e l'articolo relativo all'utilizzo di log per tenere traccia delle richiesta di archiviazione nella registrazione di Azure.

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 Codici di stato e di errore relativi alla gestione dei servizi.

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.

x-ms-version

Specifica la versione dell'operazione utilizzata per la risposta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

Per la versione 2012-02-12 e precedenti, il formato del corpo della risposta è il seguente:

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>version-number</Version>
        <Delete>true|false</Delete>
        <Read>true|false</Read>
        <Write>true|false</Write>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Logging>
    <Metrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Metrics>
</StorageServiceProperties>

A partire dalla versione 2013-08-15, il formato del corpo della risposta è il seguente:

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>version-number</Version>
        <Delete>true|false</Delete>
        <Read>true|false</Read>
        <Write>true|false</Write>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </Logging>
    <HourMetrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </HourMetrics>
    <MinuteMetrics>
        <Version>version-number</Version>
        <Enabled>true|false</Enabled>
        <IncludeAPIs>true|false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true|false</Enabled>
            <Days>number-of-days</Days>
        </RetentionPolicy>
    </MinuteMetrics>
    <Cors>
        <CorsRule>
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>
            <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>
            <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders>
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>
        </CorsRule>
    </Cors>
</StorageServiceProperties>

Nella tabella seguente vengono descritti gli elementi del corpo della risposta:

 

Nome elemento Descrizione

Logging

Raggruppa le impostazioni di Logging di Azure Analytics.

Metrics

Raggruppa le impostazioni di Metrics di Azure Analytics. Le impostazioni Metrics forniscono un riepilogo delle statistiche sulle richieste raggruppate per API nelle aggregazioni orarie per le code.

HourMetrics

Raggruppa le impostazioni di HourMetrics di Azure Analytics. Le impostazioni HourMetrics forniscono un riepilogo delle statistiche sulle richieste raggruppate per API nelle aggregazioni orarie per le code.

MinuteMetrics

Raggruppa le impostazioni di MinuteMetrics di Azure Analytics. Le impostazioni MinuteMetrics forniscono statistiche sulle richieste per ogni minuto per le code.

Version

Versione di Analisi archiviazione in uso.

Delete

Si applica solo alla configurazione della registrazione. Indica se le richieste di eliminazione vengono registrate.

Read

Si applica solo alla configurazione della registrazione. Indica se le richieste di lettura vengono registrate.

Write

Si applica solo alla configurazione della registrazione. Indica se le richieste di scrittura vengono registrate.

Enabled

Indica se le metriche sono abilitate per il servizio di accodamento.

Se la replica geograficamente ridondante con accesso in lettura è abilitata, verranno raccolte sia le metriche primarie sia secondarie. Se la replica geograficamente ridondante con accesso in lettura non è abilitata, verranno raccolte solo le metriche primarie.

IncludeAPIs

Si applica solo alla configurazione della metrica. Indica se le metriche generano statistiche di riepilogo per le operazioni API chiamate.

RetentionPolicy/Enabled

Indica se i criteri di conservazione sono abilitati per il servizio di archiviazione.

RetentionPolicy/Days

Indica il numero di giorni per cui devono essere mantenuti i dati di registrazione o di metrica. Tutti i dati che precedono questo valore verranno eliminati.

Cors

Raggruppa tutte le regole CORS.

CorsRule

Raggruppa le impostazioni per una regola CORS.

AllowedOrigins

Elenco separato da virgole dei domini di origine consentiti tramite CORS o "*" se tutti i domini sono consentiti.

ExposedHeaders

Elenco separato da virgole delle intestazioni delle risposte da esporre ai client CORS.

MaxAgeInSeconds

Numero di secondi durante i quali il client/browser deve memorizzare nella cache una risposta preliminare.

AllowedHeaders

Elenco separato da virgole delle intestazioni che possono far parte della richiesta multiorigine.

AllowedMethods

Elenco separato da virgole dei metodi HTTP che possono essere eseguiti dall'origine. Per Archiviazione di Azure, i metodi consentiti sono DELETE, GET, HEAD, MERGE, POST, OPTIONS o PUT.

Solo il proprietario dell'account di archiviazione può chiamare questa operazione.

L'URI di esempio seguente consente di effettuare una richiesta per ottenere le proprietà del servizio di accodamento per l'account di archiviazione fittizio denominato myaccount:

GET https://myaccount.queue.core.windows.net/?restype=service&comp=properties HTTP/1.1

La richiesta viene inviata con le intestazioni seguenti:

x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 04:49:03 GMT
Authorization: SharedKey
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=
Host: myaccount.queue.core.windows.net

Dopo l'invio della richiesta viene restituita la risposta seguente:

HTTP/1.1 200 OK
Content-Length: 1020
Content-Type: application/xml
Date: Wed, 23 Oct 2013 04:49:04 GMT
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30
x-ms-version: 2013-08-15

Il corpo della risposta è simile al seguente:

<?xml version="1.0" encoding="utf-8"?>
<StorageServiceProperties>
    <Logging>
        <Version>1.0</Version>
        <Delete>true</Delete>
        <Read>false</Read>
        <Write>true</Write>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </Logging>
    <HourMetrics>
        <Version>1.0</Version>
        <Enabled>true</Enabled>
        <IncludeAPIs>false</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </HourMetrics>
        <MinuteMetrics>
        <Version>1.0</Version>
        <Enabled>true</Enabled>
        <IncludeAPIs>true</IncludeAPIs>
        <RetentionPolicy>
            <Enabled>true</Enabled>
            <Days>7</Days>
        </RetentionPolicy>
    </MinuteMetrics>
    <Cors>
        <CorsRule>
            <AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>
            <AllowedMethods>GET,PUT</AllowedMethods>
            <MaxAgeInSeconds>500</MaxAgeInSeconds>
            <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>
            <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>
        </CorsRule>
    </Cors>
</StorageServiceProperties>

Vedere anche

Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft