Skip to content

Commit 5bebfe3

Browse files
committed
edits
1 parent ca1f4bb commit 5bebfe3

File tree

2 files changed

+12
-13
lines changed

2 files changed

+12
-13
lines changed

articles/api-management/api-management-get-started-publish-versions.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,7 @@ In this tutorial, you learn how to:
4242

4343
1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
4444
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.
4846

4947
:::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":::
5048

@@ -53,20 +51,20 @@ In this tutorial, you learn how to:
5351
5452
## Choose a versioning scheme
5553

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.
5755

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.
5957

6058
|Setting |Value |Description |
6159
|---------|---------|---------|
6260
|**Version identifier** | *v1* | Scheme-specific indicator of the version. For **Path**, the suffix for the API URL path. |
6361
|**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. |
6563
|**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. |
6664

6765
:::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":::
6866

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**:
7068

7169
:::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":::
7270

@@ -81,14 +79,15 @@ After you add the version, you can edit and configure it as an API that's separa
8179

8280
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.
8381

84-
For example, to add the version to the **Unlimited** product:
82+
To add the version to a product:
8583

86-
1. In the Azure portal, navigate to your API Management instance.
87-
1. Select **Products** > **Unlimited** > **APIs** > **+ Add**.
88-
1. Select **Swagger Petstore**, version **v1**.
89-
1. Click **Select**.
84+
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**.
9089

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":::
9291

9392
## Use version sets
9493

Loading

0 commit comments

Comments
 (0)