取得佇列服務屬性

發行項
06/27/2023

作業 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 儲存體提出要求。
`Date` 或 `x-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 規格