Skip to content

Commit 0ebc073

Browse files
committed
Address comments
1 parent f689d44 commit 0ebc073

File tree

2 files changed

+27
-18
lines changed

2 files changed

+27
-18
lines changed

articles/azure-app-configuration/rest-api-key-value.md

Lines changed: 20 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -112,12 +112,10 @@ Optional: ``key`` (If not specified, it implies any key.)
112112
Optional: ``label`` (If not specified, it implies any label.)
113113

114114
:::zone-end
115-
:::zone target="docs" pivot="v23-11"
116-
117-
Optional: ``tags`` (If not specified, it implies any tags.)
115+
:::zone target="docs" pivot="v1,v23-10"
118116

119117
```http
120-
GET /kv?key=Test*&tags=tag1=value1&tags=tag2=value2&api-version={api-version} HTTP/1.1
118+
GET /kv?label=*&api-version={api-version} HTTP/1.1
121119
```
122120

123121
**Response:**
@@ -126,11 +124,14 @@ GET /kv?key=Test*&tags=tag1=value1&tags=tag2=value2&api-version={api-version} HT
126124
HTTP/1.1 200 OK
127125
Content-Type: application/vnd.microsoft.appconfig.kvset+json; charset=utf-8
128126
```
127+
129128
:::zone-end
130-
:::zone target="docs" pivot="v1,v23-10,v23-11"
129+
:::zone target="docs" pivot="v23-11"
130+
131+
Optional: ``tags`` (If not specified, it implies any tags.)
131132

132133
```http
133-
GET /kv?label=*&api-version={api-version} HTTP/1.1
134+
GET /kv?key=Test*&label=*&tags=tag1=value1&tags=tag2=value2&api-version={api-version} HTTP/1.1
134135
```
135136

136137
**Response:**
@@ -139,6 +140,8 @@ GET /kv?label=*&api-version={api-version} HTTP/1.1
139140
HTTP/1.1 200 OK
140141
Content-Type: application/vnd.microsoft.appconfig.kvset+json; charset=utf-8
141142
```
143+
:::zone-end
144+
:::zone target="docs" pivot="v1,v23-10,v23-11"
142145

143146
For additional options, see the "Filtering" section later in this article.
144147

@@ -219,13 +222,22 @@ Link: <{relative uri}>; rel="next"
219222

220223
## Filtering
221224

225+
:::zone-end
226+
:::zone target="docs" pivot="v1,v23-10"
227+
222228
A combination of `key` and `label` filtering is supported.
223229
Use the optional `key` and `label` query string parameters.
224230

231+
```http
232+
GET /kv?key={key}&label={label}&api-version={api-version}
233+
```
234+
225235
:::zone-end
226236
:::zone target="docs" pivot="v23-11"
227237

228-
For API Versions greater than `2023-11-01`, filtering by `tags` is also supported. Multiple tag filters can be provided as query string parameters in the `tagName=tagValue` format. Tag filters must be an exact match.
238+
A combination of `key`, `label` and `tags` filtering is supported.
239+
Use the optional `key`, `label` and `tags` query string parameters.
240+
Multiple tag filters can be provided as query string parameters in the `tagName=tagValue` format. Tag filters must be an exact match.
229241

230242
```http
231243
GET /kv?key={key}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version={api-version}
@@ -234,9 +246,6 @@ GET /kv?key={key}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version=
234246
:::zone-end
235247
:::zone target="docs" pivot="v1,v23-10,v23-11"
236248

237-
```http
238-
GET /kv?key={key}&label={label}&api-version={api-version}
239-
```
240249

241250
### Supported filters
242251

@@ -262,7 +271,7 @@ GET /kv?key={key}&label={label}&api-version={api-version}
262271
|--|--|
263272
|`tags` is omitted or `tags=` |Matches **any** tag|
264273
|`tags=group=app1`|Matches KV where the tag name is `group` and tag value is `app1`|
265-
|`tags=group=app1&tags=env=prod`|Matches KV which contain at least 2 tags, where the tag names are `group` and `env` and tag values are `app1` and `prod` respectively (limited to 5 tag filters)|
274+
|`tags=group=app1&tags=env=prod`|Matches KV that have a tag named `group` with value `app1` and a tag named `env` with value `prod`(limited to 5 tag filters)|
266275
|`tags=tag1=%00`|Matches KV where the tag name is `tag1` and tag value is `null`|
267276
|`tags=tag1=`|Matches KV where the tag name is `tag1` and tag value is empty|
268277

articles/azure-app-configuration/rest-api-snapshot.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -365,19 +365,19 @@ Content-Type: application/vnd.microsoft.appconfig.snapshot+json
365365

366366
```json
367367
{
368-
"filters": [ // required
368+
"filters": [ // required
369369
{
370-
"key": "app1/*", // required
371-
"label": "prod", // optional
372-
"tags": ["group=g1", "default=true"] // optional
370+
"key": "app1/*", // required
371+
"label": "prod", // optional
372+
"tags": ["group=g1", "default=true"] // optional
373373
}
374374
],
375-
"tags": { // optional
375+
"tags": { // optional
376376
"tag1": "value1",
377377
"tag2": "value2",
378378
},
379-
"composition_type": "key", // optional
380-
"retention_period": 2592000 // optional
379+
"composition_type": "key", // optional
380+
"retention_period": 2592000 // optional
381381
}
382382
```
383383

0 commit comments

Comments
 (0)