导出 (0) 打印
全部展开

获取表服务属性

更新时间: 2013年12月

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

对于所有验证的请求是必需的。指定用于此请求的操作的版本。有关详细信息,请参阅Azure 存储服务版本化

x-ms-client-request-id

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

无。

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

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

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

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

 

响应标头 说明

x-ms-request-id

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

x-ms-version

指定用于响应的操作版本。有关详细信息,请参阅Azure 存储服务版本化

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

Metrics

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

HourMetrics

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

MinuteMetrics

对 Azure Analytics MinuteMetrics 设置进行分组。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>

另请参阅

显示:
© 2014 Microsoft