Skip to content

Commit 72c63e5

Browse files
Merge pull request #221868 from tomkerkhove/patch-6
fix(apim): Clarify that revision IDs must be specified as part of API ID
2 parents 3a2fbce + 3c3b145 commit 72c63e5

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

articles/api-management/api-management-revisions.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,10 +30,13 @@ With revisions you can:
3030

3131
Each revision to your API can be accessed using a specially formed URL. Append `;rev={revisionNumber}` at the end of your API URL, but before the query string, to access a specific revision of that API. For example, you might use this URL to access revision 3 of the `customers` API:
3232

33-
`https://apis.contoso.com/customers;rev=3?customerId=123`
33+
`https://apis.contoso.com/customers;rev=3/leads?customerId=123`
3434

3535
By default, each revision has the same security settings as the current revision. You can deliberately change the policies for a specific revision if you want to have different security applied for each revision. For example, you might want to add a [IP filtering policy](./api-management-access-restriction-policies.md#RestrictCallerIPs) to prevent external callers from accessing a revision that is still under development.
3636

37+
> [!NOTE]
38+
> The `;rev={id}` must be appended to the API ID, and not the URI path.
39+
3740
## Current revision
3841

3942
A single revision can be set as the *current* revision. This revision will be the one used for all API requests that don't specify an explicit revision number in the URL. You can roll back to a previous revision by setting that revision as current.

0 commit comments

Comments
 (0)