此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
导出 (0) 打印
全部展开

获取表服务属性

更新时间: 2015年4月

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

有关 CORS 规则和评估逻辑的详细信息,请参阅 对 Azure 存储服务的跨域资源共享 (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 参数 说明

restype=service&comp=properties

必需。要获取表服务属性,必须组合这两个查询字符串。

timeout

可选。timeout 参数以秒表示。

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

 

请求标头 说明

Authorization

必需。指定身份验证方案、存储帐户名和签名。有关详细信息,请参阅Azure 存储服务身份验证

Datex-ms-date

必需。为请求指定协调世界时 (UTC)。有关详细信息,请参阅Azure 存储服务身份验证

x-ms-version

对于所有验证的请求是必需的。指定用于此请求的操作的版本。有关详细信息,请参阅Windows Azure 中 BLOB 服务、队列服务和表服务的版本管理

x-ms-client-request-id

可选。提供客户端生成的、附带 1 KB 字符限制的模糊值,在启用存储分析日志记录时,将在分析日志中记录该值。强烈建议使用此标头将客户端活动与服务器接收的请求相关联。有关详细信息,请参阅关于存储分析日志记录Azure 日志记录:使用日志跟踪存储请求

无。

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

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

有关状态代码的信息,请参阅服务管理状态和错误代码

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

 

响应标头 说明

x-ms-request-id

唯一地标识针对服务发出的请求的值。

x-ms-version

指定用于响应的操作版本。有关详细信息,请参阅Windows Azure 中 BLOB 服务、队列服务和表服务的版本管理

对于 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 AnalyticsLogging 设置进行分组。

Metrics

对 Azure AnalyticsMetrics 设置进行分组。此Metrics 设置汇总了表的每小时聚合中按 API 分组的请求统计信息。

HourMetrics

对 Azure AnalyticsHourMetrics 设置进行分组。此HourMetrics 设置汇总了表的每小时聚合中按 API 分组的请求统计信息。

MinuteMetrics

对 Azure AnalyticsMinuteMetrics 设置进行分组。此MinuteMetrics 设置提供了表每分钟的请求统计信息。

Version

当前正在使用中的存储分析版本。

删除

仅适用于日志记录配置。指示是否将记录删除请求。

读取

仅适用于日志记录配置。指示是否将记录读取请求。

写入

仅适用于日志记录配置。指示是否将记录写入请求。

已启用

指示是否为表服务启用度量。

如果启用了读访问的地域冗余复制,则同时收集主度量值和辅助度量值。如果未启用读访问的地域冗余复制,则仅收集主度量值。

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>

另请参阅

显示:
© 2015 Microsoft