Get Queue Service Properties
Comprimi il sommario
Espandi il sommario
Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Get Queue Service Properties

 

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 Cross-Origin Resource condivisione supporto (CORS) per i servizi di archiviazione di Azure.

La richiesta di Get Queue Service Properties può essere specificata come indicato di seguito. È consigliato il protocollo 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 richiesta è possibile specificare i seguenti parametri aggiuntivi.

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

Facoltativa. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione di timeout per le operazioni di servizio di Accodamento.

Nella seguente tabella 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 usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

x-ms-client-request-id

Facoltativa. Fornisce un valore un opaco generato dal client con limite di caratteri pari a 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'uso di questa intestazione è fortemente consigliato per la correlazione delle attività lato client con le richieste ricevute dal server. Per ulteriori informazioni, vedere Informazioni sulla registrazione di analisi archiviazione e la registrazione di Azure: Utilizzo dei log per tenere traccia delle richieste di archiviazione.

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 200 (OK).

Per informazioni sui codici di stato, vedere stato di gestione del servizio e i codici di errore.

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

La seguente tabella descrive gli elementi del corpo della risposta:

Nome elemento

Descrizione

Logging

Raggruppa le impostazioni Logging di Azure Analytics.

Metrics

Raggruppa le impostazioni 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 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 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 il servizio di 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>
Mostra:
© 2016 Microsoft