你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

获取表服务属性

Get Table Service Properties操作获取存储帐户表服务的属性,包括存储分析和 CORS (跨域资源共享) 规则的属性。

有关 CORS 规则和评估逻辑的详细信息,请参阅 CORS 对 存储 服务的 CORS 支持

请求

可以按以下方式指定 Get Table Service Properties 请求。 建议使用 HTTPS。 将 <account-name> 替换为你的存储帐户名称:

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

请注意,URI 必须始终包含正斜杠 (/),以将主机名与 URI 的路径和查询部分隔开。 在执行此操作时,URI 的路径部分是空的。

URI 参数

URI 参数 说明
restype=service&comp=properties 必需。 要获取表服务属性,必须组合这两个查询字符串。
timeout 可选。 timeout 参数以秒表示。

请求标头

下表介绍必需的和可选的请求标头。

请求标头 说明
Authorization 必需。 指定授权方案、存储帐户名称和签名。 有关详细信息,请参阅授权对Azure 存储的请求
Datex-ms-date 必需。 指定请求的协调世界时 (UTC)。 有关详细信息,请参阅授权对Azure 存储的请求
x-ms-version 所有授权请求都是必需的。 指定用于此请求的操作的版本。 有关详细信息,请参阅Azure 存储服务的版本控制
x-ms-client-request-id 可选。 提供客户端生成的不透明值,该值具有 1 KiB 字符限制,在启用存储分析日志记录时记录在分析日志中。 强烈建议使用此标头将客户端活动与服务器接收的请求相关联。 有关详细信息,请参阅关于存储分析日志记录Azure 日志记录:使用日志跟踪存储请求

请求正文

无。

响应

响应包括 HTTP 状态代码、一组响应标头和响应正文。

状态代码

此操作成功后返回状态代码 200(正常)。

响应标头

此操作的响应包括以下标头。 该响应还可能包括其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范

响应标头 说明
x-ms-request-id 唯一地标识针对服务发出的请求的值。
x-ms-version 指定用于响应的操作版本。 有关详细信息,请参阅Azure 存储服务的版本控制
x-ms-client-request-id 此标头可用于对请求和相应的响应进行故障排除。 如果此标头存在于请求中并且该值最多为 1024 个可见 ASCII 字符, x-ms-client-request-id 则此标头的值等于标头的值。 如果请求中不存在标头 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-seperated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>  
  

下表介绍响应正文的元素:

元素名称 说明
Logging 对 Azure Analytics Logging 设置进行分组。
度量值 对 Azure Analytics 指标 设置进行分组。 Metrics 设置汇总了表的每小时聚合中按 API 分组的请求统计信息。
HourMetrics 对 Azure Analytics HourMetrics 设置进行分组。 HourMetrics 设置汇总了表的每小时聚合中按 API 分组的请求统计信息。
MinuteMetrics 对 Azure Analytics MinuteMetrics 设置进行分组。 MinuteMetrics 设置提供了表每分钟的请求统计信息。
版本 当前正在使用中的存储分析版本。
删除 仅适用于日志记录配置。 指示是否将记录删除请求。
读取 仅适用于日志记录配置。 指示是否将记录读取请求。
写入 仅适用于日志记录配置。 指示是否将记录写入请求。
Enabled 指示是否为表服务启用度量。

如果启用了读访问的地域冗余复制,则同时收集主度量值和辅助度量值。 如果未启用读访问的地域冗余复制,则仅收集主度量值。
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.table.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.table.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-Table/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>  

另请参阅

存储分析
对存储服务的 CORS 支持
CORS HTTP 规范