共用方式為


取得佇列服務屬性

作業 Get Queue Service Properties 會取得 Azure 佇列儲存體帳戶的屬性,包括儲存體分析和跨原始來源資源分享的屬性, (CORS) 規則。

如需跨原始來源資源分享 (CORS) 規則和評估邏輯的詳細資訊,請參閱 Azure 儲存體服務的 CORS 支援

要求

請使用下列格式指定 Get Queue Service Properties 要求。 建議您使用 HTTPS。 以儲存體帳戶的名稱取代 < account-name > :

方法 要求 URI HTTP 版本
GET https://<account-name>.queue.core.windows.net/?restype=service&comp=properties HTTP/1.1

注意

URI 必須一律包含斜線字元 (/) ,以分隔主機名稱與 URI 的路徑和查詢部分。 在此作業中,URI 的路徑部分是空的。

URI 參數

您可以在要求 URI 上指定下列其他參數:

參數 描述
restype=service&comp=properties 必要。 若要取得儲存體服務屬性,需要兩個查詢字串的組合。
timeout 選擇性。 timeout 參數以秒為單位。 如需詳細資訊,請參閱 設定 Azure 佇列儲存體作業的逾時

要求標頭

下表描述必要的和選用的要求標頭。

要求標頭 描述
Authorization 必要。 指定授權配置、儲存體帳戶名稱和簽章。 如需詳細資訊,請參閱授權對 Azure 儲存體提出要求
Datex-ms-date 必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊,請參閱授權對 Azure 儲存體提出要求
x-ms-version 所有授權要求都需要。 指定用於這個要求的作業版本。 如需詳細資訊,請參閱 Azure 儲存體服務的版本
x-ms-client-request-id 選擇性。 提供用戶端產生的不透明值,其中包含 1-kibibyte (KiB) 設定記錄時記錄在記錄中的字元限制。 強烈建議您使用此標頭,將用戶端活動與伺服器收到的要求相互關聯。 如需詳細資訊,請參閱 監視 Azure 佇列儲存體

要求本文

無。

回應

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

回應標頭

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格

回應標頭 描述
x-ms-request-id 唯一識別對服務提出的要求。
x-ms-version 指定用於回應的作業版本。 如需詳細資訊,請參閱 Azure 儲存體服務的版本
x-ms-client-request-id 可用來針對要求和對應的回應進行疑難排解。 如果此標頭存在於要求中,則此標頭的值等於標頭的值 x-ms-client-request-id ,且值不包含超過 1,024 個可見的 ASCII 字元。 x-ms-client-request-id如果要求中沒有標頭,則不會出現在回應中。

回應本文

2012-02-12 版及更早版本回應主體的格式如下:

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

自 2013-08-15 版起,回應本文的格式如下所示:

<?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-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-separated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>  
  

下表描述回應主體的元素:

元素名稱 Description
Logging 將儲存體分析記錄設定分組。
計量 將儲存體分析計量設定分組。 Metrics 設定提供依應用程式開發介面分組,對佇列進行每小時彙總的要求統計資料摘要。
HourMetrics 將儲存體分析HourMetrics設定分組。 HourMetrics 設定提供依應用程式開發介面分組,對佇列進行每小時彙總的要求統計資料摘要。
MinuteMetrics 將儲存體分析MinuteMetrics* 設定分組。 MinuteMetrics 設定提供佇列每一分鐘的要求統計資料。
版本 目前使用的儲存體分析版本。
刪除 僅適用于記錄組態。 指出是否會記錄刪除要求。
讀取 僅適用于記錄組態。 指出是否會記錄讀取要求。
寫入 僅適用于記錄組態。 指出是否會記錄寫入要求。
Enabled 指出是否啟用 Azure 佇列儲存體的計量。

如果啟用了讀取權限的地理備援複寫,將會一併收集主要和次要度量。 如果未啟用讀取權限的地理備援複寫,只會收集主要度量。
IncludeAPIs 只適用於度量組態。 指出度量是否會產生所呼叫之 API 作業的摘要統計資料。
RetentionPolicy/Enabled 指出是否已啟用儲存體服務的保留原則。
RetentionPolicy/Days 指出度量或記錄資料的保留天數。 比此值更早的所有資料將會遭到刪除。
Cors 將所有 CORS 規則分組。
CorsRule 將 CORS 規則的設定分組。
AllowedOrigins 允許所有網域時,透過 CORS 或星號 (*) 允許的原始網域逗號分隔清單。
ExposedHeaders 向 CORS 用戶端公開的回應標頭以逗號分隔的清單。
MaxAgeInSeconds 用戶端或瀏覽器應該快取預檢回應的秒數。
AllowedHeaders 允許成為跨原始來源要求一部分之標頭的逗號分隔清單。
AllowedMethods 允許由原始網域執行的 HTTP 方法以逗號分隔的清單。 針對 Azure 儲存體,允許的方法為 DELETE、GET、HEAD、MERGE、POST、OPTIONS 或 PUT。

授權

只有儲存體帳戶擁有者可以呼叫此作業。

範例要求與回應

下列範例 URI 要求取得虛構儲存體帳戶 myaccount 的佇列服務屬性:

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

所傳送的要求包含下列標頭:

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  

傳送要求之後,會傳回下列回應:

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  
  

回應主體如下所示:

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

另請參閱

Storage Analytics
Azure 儲存體服務的 CORS 支援
CORS HTTP 規格