Update all docs with API versions

avanigupta · avanigupta · commit 74d71bf8ff93 · 2024-08-02T11:32:03.000-07:00
diff --git a/articles/azure-app-configuration/rest-api-key-value.md b/articles/azure-app-configuration/rest-api-key-value.md
@@ -5,7 +5,7 @@ author: maud-lv
 ms.author: malev
 ms.service: azure-app-configuration
 ms.topic: reference
-ms.date: 07/23/2024
+ms.date: 08/02/2024
 zone_pivot_groups: data-plane-api-version
 
 ---
@@ -108,6 +108,7 @@ HTTP/1.1 200 OK
 ## List key-values
 
 Optional: ``key`` (If not specified, it implies any key.)
+
 Optional: ``label`` (If not specified, it implies any label.)
 
 :::zone-end
@@ -224,7 +225,7 @@ Use the optional `key` and `label` query string parameters.
 :::zone-end
 :::zone target="docs" pivot="v23-11"
 
-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. 
+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. 
 
 ```http
 GET /kv?key={key}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version={api-version}
diff --git a/articles/azure-app-configuration/rest-api-keys.md b/articles/azure-app-configuration/rest-api-keys.md
@@ -5,13 +5,14 @@ author: maud-lv
 ms.author: malev
 ms.service: azure-app-configuration
 ms.topic: reference
-ms.date: 08/17/2020
+ms.date: 08/02/2024
+zone_pivot_groups: data-plane-api-version
+
 ---
+:::zone target="docs" pivot="v1,v23-10,v23-11"
 
 # Keys
 
-api-version: 1.0
-
 The following syntax represents a key resource:
 
 ```http
@@ -175,3 +176,5 @@ Link: <relative uri>; rel="original"
     ]
 }
 ```
+
+:::zone-end
diff --git a/articles/azure-app-configuration/rest-api-labels.md b/articles/azure-app-configuration/rest-api-labels.md
@@ -5,13 +5,14 @@ author: maud-lv
 ms.author: malev
 ms.service: azure-app-configuration
 ms.topic: reference
-ms.date: 08/17/2020
+ms.date: 08/02/2024
+zone_pivot_groups: data-plane-api-version
+
 ---
+:::zone target="docs" pivot="v1,v23-10,v23-11"
 
 # Labels
 
-api-version: 1.0
-
 The **Label** resource is defined as follows:
 
 ```json
@@ -93,7 +94,7 @@ GET /labels?name={label-name}&api-version={api-version}
 
 ### Supported filters
 
-|Key Filter|Effect|
+|Label Filter|Effect|
 |--|--|
 |`name` is omitted or `name=*`|Matches **any** label|
 |`name=abc`|Matches a label named  **abc**|
@@ -178,3 +179,5 @@ Link: <{relative uri}>; rel="original"
     ]
 }
 ```
+
+:::zone-end
diff --git a/articles/azure-app-configuration/rest-api-locks.md b/articles/azure-app-configuration/rest-api-locks.md
@@ -5,12 +5,15 @@ author: maud-lv
 ms.author: malev
 ms.service: azure-app-configuration
 ms.topic: reference
-ms.date: 08/17/2020
+ms.date: 08/02/2024
+zone_pivot_groups: data-plane-api-version
+
 ---
+:::zone target="docs" pivot="v1,v23-10,v23-11"
 
 # Locks
 
-This API (version 1.0) provides lock and unlock semantics for the key-value resource. It supports the following operations:
+This API provides lock and unlock semantics for the key-value resource. It supports the following operations:
 
 - Place lock
 - Remove lock
@@ -108,3 +111,5 @@ The following request applies the operation only if the current key-value repres
 PUT|DELETE /kv/{key}?label={label}&api-version={api-version} HTTP/1.1
 If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
 ```
+
+:::zone-end
diff --git a/articles/azure-app-configuration/rest-api-revisions.md b/articles/azure-app-configuration/rest-api-revisions.md
@@ -5,8 +5,11 @@ author: maud-lv
 ms.author: malev
 ms.service: azure-app-configuration
 ms.topic: reference
-ms.date: 08/17/2020
+ms.date: 08/02/2024
+zone_pivot_groups: data-plane-api-version
+
 ---
+:::zone target="docs" pivot="v1,v23-10,v23-11"
 
 # Key-value revisions
 
@@ -100,6 +103,18 @@ Content-Range: items 0-2/80
 A combination of `key` and `label` filtering is supported.
 Use the optional `key` and `label` query string parameters.
 
+:::zone-end
+:::zone target="docs" pivot="v23-11"
+
+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. 
+
+```http
+GET /revisions?key={key}&label={label}&tags={tagFilter1}&tags={tagFilter2}&api-version={api-version}
+```
+
+:::zone-end
+:::zone target="docs" pivot="v1,v23-10,v23-11"
+
 ```http
 GET /revisions?key={key}&label={label}&api-version={api-version}
 ```
@@ -125,6 +140,20 @@ GET /revisions?key={key}&label={label}&api-version={api-version}
 |`label=*prod*`|Matches labels that contain **prod**|
 |`label=prod,test`|Matches labels **prod** or **test** (limited to 5 CSV)|
 
+:::zone-end
+:::zone target="docs" pivot="v23-11"
+
+|Tags filter|Effect|
+|--|--|
+|`tags` is omitted or `tags=` |Matches **any** tag|
+|`tags=group=app1`|Matches KV where the tag name is `group` and tag value is `app1`|
+|`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)|
+|`tags=tag1=%00`|Matches KV where the tag name is `tag1` and tag value is `null`|
+|`tags=tag1=`|Matches KV where the tag name is `tag1` and tag value is empty|
+
+:::zone-end
+:::zone target="docs" pivot="v1,v23-10,v23-11"
+
 ### Reserved characters
 
 The reserved characters are:
@@ -205,3 +234,5 @@ Link: <{relative uri}>; rel="original"
     ]
 }
 ```
+
+:::zone-end
diff --git a/articles/azure-app-configuration/rest-api-snapshot.md b/articles/azure-app-configuration/rest-api-snapshot.md
@@ -5,15 +5,16 @@ author: jimmyca15
 ms.author: jimmyca
 ms.service: azure-app-configuration
 ms.topic: reference
-ms.date: 03/21/2023
+ms.date: 08/02/2024
+zone_pivot_groups: data-plane-api-version
+
 ---
+:::zone target="docs" pivot="v23-10,v23-11"
 
 # Snapshot
 
 A snapshot is a resource identified uniquely by its name. See details for each operation.
 
-This article applies to API version 2022-11-01-preview.
-
 ## Operations
 
 - Get
@@ -48,13 +49,30 @@ This article applies to API version 2022-11-01-preview.
 
 `SnapshotFilter`
 
+:::zone-end
+:::zone target="docs" pivot="v23-10"
+
 ```json
 {
   "key": [string],
   "label": [string]
 }
 ```
 
+:::zone-end
+:::zone target="docs" pivot="v23-11"
+
+```json
+{
+  "key": [string],
+  "label": [string],
+  "tags": [array<string>]
+}
+```
+
+:::zone-end
+:::zone target="docs" pivot="v23-10,v23-11"
+
 ## Get snapshot
 
 Required: ``{name}``, ``{api-version}``  
@@ -256,15 +274,22 @@ GET /snapshot?$select=name,status&api-version={api-version} HTTP/1.1
 | name | yes | n/a | Length <br/> &nbsp;&nbsp;&nbsp;&nbsp; maximum: 256 | 
 | filters | yes | n/a | Count <br/> &nbsp;&nbsp;&nbsp;&nbsp; minimum: 1<br/> &nbsp;&nbsp;&nbsp;&nbsp; maximum: 3 |
 | filters[\<index\>].key | yes | n/a | |
-| tags | no | {} | |
 | filters[\<index\>].label | no | null | Multi-match label filters (E.g.: "*", "comma,separated") aren't supported with 'key' composition type. |
+:::zone-end
+:::zone target="docs" pivot="v23-11"
+| filters[\<index\>].tags | no | null | Count <br/> &nbsp;&nbsp;&nbsp;&nbsp; minimum: 0<br/> &nbsp;&nbsp;&nbsp;&nbsp; maximum: 5 |
+:::zone-end
+:::zone target="docs" pivot="v23-10,v23-11"
+| tags | no | {} | |
 | composition_type | no | key | |
 | retention_period | no | Standard tier <br/>&nbsp;&nbsp;&nbsp;&nbsp; 2592000 (30 days) <br/> Free tier <br/> &nbsp;&nbsp;&nbsp;&nbsp; 604800 (7 days) | Standard tier <br/> &nbsp;&nbsp;&nbsp;&nbsp; minimum: 3600 (1 hour) <br/> &nbsp;&nbsp;&nbsp;&nbsp; maximum: 7776000 (90 days) <br/> Free tier <br/> &nbsp;&nbsp;&nbsp;&nbsp; minimum: 3600 (1 hour) <br/> &nbsp;&nbsp;&nbsp;&nbsp; maximum: 604800 (7 days) |
 
 ```http
 PUT /snapshot/{name}?api-version={api-version} HTTP/1.1
 Content-Type: application/vnd.microsoft.appconfig.snapshot+json
 ```
+:::zone-end
+:::zone target="docs" pivot="v23-10"
 
 ```json
 {
@@ -316,6 +341,64 @@ Operation-Location: {appConfigurationEndpoint}/operations?snapshot={name}&api-ve
 }
 ```
 
+:::zone-end
+:::zone target="docs" pivot="v23-11"
+
+```json
+{
+  "filters": [                        // required
+    {
+      "key": "app1/*",                // required
+      "label": "prod",                 // optional
+      "tags": ["group=g1", "default=true"]   // optional
+    }
+  ],
+  "tags": {                           // optional
+    "tag1": "value1",
+    "tag2": "value2",
+  },
+  "composition_type": "key",          // optional
+  "retention_period": 2592000         // optional
+}
+```
+
+**Responses:**
+
+```http
+HTTP/1.1 201 Created
+Content-Type: application/vnd.microsoft.appconfig.snapshot+json; charset=utf-8
+Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT
+ETag: "4f6dd610dd5e4deebc7fbaef685fb903"
+Operation-Location: {appConfigurationEndpoint}/operations?snapshot={name}&api-version={api-version}
+```
+
+```json
+{
+  "etag": "4f6dd610dd5e4deebc7fbaef685fb903",
+  "name": "{name}",
+  "status": "provisioning",
+  "filters": [
+      {
+          "key": "app1/*",
+          "label": "prod",
+          "tags": ["group=g1", "default=true"]
+      }
+  ],
+  "composition_type": "key",
+  "created": "2023-03-20T21:00:03+00:00",
+  "size": 2000,
+  "items_count": 4,
+  "tags": {
+    "t1": "value1",
+    "t2": "value2"
+  },
+  "retention_period": 2592000
+}
+```
+
+:::zone-end
+:::zone target="docs" pivot="v23-10,v23-11"
+
 The status of the newly created snapshot will be "provisioning".
 Once the snapshot is fully provisioned, the status will update to "ready".
 Clients can poll the snapshot to wait for the snapshot to be ready before listing its associated key-values.
@@ -552,3 +635,5 @@ Use the optional `$select` query string parameter and provide a comma-separated
 ```http
 GET /kv?snapshot={name}&$select=key,value&api-version={api-version} HTTP/1.1
 ```
+
+:::zone-end
