增强功能标志修订

该 API 版本不支持增强功能标志的修订版本。

增强型特征标志修订定义了增强型特征标志资源的历史表示方式。免费和开发者套餐商店的修订版在7天后过期，标准版和高级版商店则为30天。修订版支持了该 List 操作。

对于所有操作，都是 name 可选参数。如果省略，则意味着任何特征标志名称。

对于所有操作，都是 label 可选参数。如果省略，则意味着任何标签。

重要

增强功能标志修订端点仅在 2026-05-01-preview API 版本中提供。

先决条件

所有 HTTP 请求都必须经过身份验证。请参阅身份验证部分。
所有 HTTP 请求都必须提供显式的 api-version。请参阅版本控制部分。

列表修订

可选： name （如果未指定，则意味着任何特征标志名称。）

可选：label（如果未指定，则表示标签可以是任何标签。）

可选：tags（如果未指定，则表示任意标记。）

可选请求头： Sync-Token （用于保证请求之间的实时一致性。）

GET /ff-revisions?name={name}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version={api-version} HTTP/1.1

响应：

HTTP/1.1 200 OK
Content-Type: application/json; profile="https://azconfig.io/mime-profiles/ffset"; charset=utf-8
ETag: "1PlB48ET4VAlB9068ft6fKMyA3m"
Sync-Token: zAJw6V16=NjotMSM3ODk3NjM=;sn=789763

{
  "items": [
    {
      "etag": "0BGYCoQ6iNdp5NtQ7N8shrobo6s",
      "name": "{name}",
      "enabled": false,
      "label": "{label}",
      "tags": {
        "t1": "value1"
      },
      "last_modified": "2026-04-30T16:52:32Z"
    },
    ...
  ],
  "@nextLink": "{relative uri}"
}

列表修订（有条件）

若要改善客户端缓存，请使用 If-Match 或 If-None-Match 请求标头。该 etag 参数是列表响应主体和头部的一部分。如果两个头部都省略，则该操作为无条件的。

以下请求只有在当前表示符合指定 etag内容时才会被修改：

GET /ff-revisions?name={name}&label={label}&api-version={api-version} HTTP/1.1
If-Match: "{etag}"

响应：

HTTP/1.1 412 Precondition Failed

或

HTTP/1.1 200 OK

以下请求只有在当前表示不匹配 etag时才会获得修订：

GET /ff-revisions?name={name}&label={label}&api-version={api-version} HTTP/1.1
If-None-Match: "{etag}"

响应：

HTTP/1.1 304 Not Modified

或

HTTP/1.1 200 OK

分页

如果返回的项数超过响应限制，则会对结果进行分页。在该 @nextLink 属性中跟进URI请求下一页。链接的URI包含 After 延续令牌和 api-version 参数。不要解码或构建 After 代币。

GET /ff-revisions?api-version={api-version} HTTP/1.1

响应：

HTTP/1.1 200 OK
Content-Type: application/json; profile="https://azconfig.io/mime-profiles/ffset"; charset=utf-8

{
  "items": [
    ...
  ],
  "@nextLink": "{relative uri}"
}

筛选

支持将 name、label 和 tags 组合起来用于筛选。使用可选的 name、label 和 tags 查询字符串参数。可以以 tagName=tagValue 格式提供多个标记筛选器作为查询字符串参数。标记筛选器必须完全匹配。

GET /ff-revisions?name={name}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version={api-version}

支持的筛选器

名称筛选器	Effect
省略 `name` 或 `name=*`	匹配任何特征标志名称
`name=abc`	匹配名为abc的特色旗帜
`name=abc*`	比赛旗名以 abc 开头
`name=*abc`	比赛旗名以abc结尾
`name=abc`	比赛中旗帜名称包含 abc
`name=abc,xyz`	比赛中旗帜名称为 abc 或 xyz （最多5个CSV）

标签筛选器	Effect
省略 `label` 或 `label=*`	匹配任何标签
`label=%00`	比赛中使用无标签的旗帜
`label=prod`	匹配标签“prod”
`label=prod*`	匹配以“prod”开头的标签
`label=*prod`	匹配以 prod 结尾的标签
`label=prod`	匹配包含生产的标签
`label=prod,test`	匹配标签“prod”或“test”（限制为 5 个 CSV）

标记筛选器	Effect
省略 `tags` 或 `tags=`	匹配任意标记
`tags=group=app1`	比赛中会有 `group` 带有标签的旗帜，标签名称带有数值 `app1`
`tags=group=app1&tags=env=prod`	匹配的标志是带有值`app1`的标签和一个以值`prod`命名`groupenv`的标签（限制为5个标签过滤器）
`tags=tag1=%00`	比赛中会有 `tag1` 带有标签的旗帜，标签名称带有数值 `null`
`tags=tag1=`	比赛中， `tag1` 标签名称为空值的标志

保留角色

保留角色有：

*、\、,

如果保留字符是值的一部分，则必须使用 \{Reserved Character} 对其进行转义。非保留字符也可以进行转义。

滤波器验证

如果发生过滤器验证错误，响应是带有错误细节的HTTP 400 ：

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://azconfig.io/errors/invalid-argument",
  "title": "Invalid request parameter '{filter}'",
  "name": "{filter}",
  "detail": "{filter}(2): Invalid character",
  "status": 400
}

Examples

所有修订版本

GET /ff-revisions?api-version={api-version}

功能标志名称以 abc 开头的修订

GET /ff-revisions?name=abc*&api-version={api-version}

功能标志名称为abc或xyz，标签包含生产的版本

GET /ff-revisions?name=abc,xyz&label=*prod*&api-version={api-version}

请求特定的字段

使用可选的 $select 查询字符串参数，并提供逗号分隔的所请求字段列表。如果省略 $select 参数，则响应会包含默认集。支持场有 name， enabled， variantsconditionsallocationlabeltelemetrydescription， tagslast_modified和。etag

GET /ff-revisions?$select=enabled,label,last_modified&api-version={api-version} HTTP/1.1

有关应用配置数据平面操作共享的请求和响应头信息，请参见通用头部。

上次更新时间为 2026-09-07