You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/api-management/api-management-get-started-publish-versions.md
+12-13Lines changed: 12 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -42,9 +42,7 @@ In this tutorial, you learn how to:
42
42
43
43
1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
44
44
1. Select **APIs**.
45
-
1. Select **Swagger Petstore** in the API list.
46
-
1. Select the context menu (**...**) next to **Swagger Petstore**.
47
-
1. Select **Add version**.
45
+
1. Locate **Swagger Petstore - OpenAPI 3.0** in the API list. Select the ellipsis (**...**) next to **Swagger Petstore - OpenAPI 3.0** and then select **Add version**. You'll add values to the resulting window in the next section.
48
46
49
47
:::image type="content" source="media/api-management-get-started-publish-versions/add-version-menu.png" alt-text="Screenshot showing the steps for adding a version." lightbox="media/api-management-get-started-publish-versions/add-version-menu.png":::
50
48
@@ -53,20 +51,20 @@ In this tutorial, you learn how to:
53
51
54
52
## Choose a versioning scheme
55
53
56
-
In API Management, you choose how callers specify the API version by selecting a *versioning scheme*: **path**, **header**, or **query string**. In the following example, *path* is used as the versioning scheme.
54
+
In API Management, you choose how callers specify the API version by selecting a *versioning scheme*: **Path**, **Header**, or **Query string**. In the following example, *Path* is used as the versioning scheme.
57
55
58
-
Enter the values from the following table. Then select **Create** to create your version.
56
+
In the **Create a new API as a version** window, enter the values from the following table. Then select **Create** to create your version.
59
57
60
58
|Setting |Value |Description |
61
59
|---------|---------|---------|
62
60
|**Version identifier**|*v1*| Scheme-specific indicator of the version. For **Path**, the suffix for the API URL path. |
63
61
|**Versioning scheme**|**Path**| The way callers specify the API version.<br/><br/> If you select **Header** or **Query string**, enter another value: the name of the header or query string parameter.<br/><br/> A usage example is displayed. |
64
-
|**Full API version name**|*swagger-petstore-v1*| Unique name in your API Management instance.<br/><br/>Because a version is actually a new API that's based on an API's [revision](api-management-get-started-revise-api.md), this setting is the new API's name. |
62
+
|**Full API version name**|*swagger-petstore-openapi-3-0-v1*| Unique name in your API Management instance.<br/><br/>Because a version is actually a new API that's based on an API's [revision](api-management-get-started-revise-api.md), this setting is the new API's name. |
65
63
|**Products**|**Unlimited** (provided in some service tiers) | Optionally, one or more products that the API version is associated with. To publish the API, you must associate it with a product. You can also [add the version to a product](#add-the-version-to-a-product) later. |
66
64
67
65
:::image type="content" source="media/api-management-get-started-publish-versions/add-version.png" alt-text="Screenshot showing window to create a new version in the portal." lightbox="media/api-management-get-started-publish-versions/add-version.png":::
68
66
69
-
After you create the version, it appears under **Swagger Petstore** in the API list. You now see two APIs: **Original** and **v1**:
67
+
After you create the version, it appears under **Swagger Petstore - OpenAPI 3.0** in the API list. You now see two APIs: **Original** and **v1**:
70
68
71
69
:::image type="content" source="media/api-management-get-started-publish-versions/version-list.png" alt-text="Screenshot that shows the list of versions." lightbox="media/api-management-get-started-publish-versions/version-list.png":::
72
70
@@ -81,14 +79,15 @@ After you add the version, you can edit and configure it as an API that's separa
81
79
82
80
For callers to see the new version, it must be added to a *product*. If you didn't already add the version to a product, you can do so at any time.
83
81
84
-
For example, to add the version to the **Unlimited** product:
82
+
To add the version to a product:
85
83
86
-
1. In the Azure portal, navigate to your API Management instance.
1. Under **APIs** in the left pane, select **Products**.
85
+
1. Select the product, and then select **APIs** in the left pane.
86
+
1. Select **+ Add**.
87
+
1. Select the API.
88
+
1. Click **Select**.
90
89
91
-
:::image type="content" source="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png" alt-text="Screenshot that shows the steps for adding a version to a product." lightbox="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png":::
90
+
:::image type="content" source="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png" alt-text="Screenshot that shows the APIs - Procuct window." lightbox="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png":::
0 commit comments