Skip to content

Commit e45ae6d

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into container-vulnerability
2 parents f5202d0 + 4518154 commit e45ae6d

File tree

104 files changed

+695
-604
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

104 files changed

+695
-604
lines changed

.openpublishing.redirection.json

Lines changed: 321 additions & 316 deletions
Large diffs are not rendered by default.

articles/api-management/api-management-howto-developer-portal.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ author: dlepow
88

99
ms.service: api-management
1010
ms.topic: article
11-
ms.date: 02/02/2022
11+
ms.date: 02/10/2022
1212
ms.author: danlep
1313
ms.custom: devx-track-azurepowershell
1414
---
@@ -44,6 +44,9 @@ Customize and style the managed portal through the built-in, drag-and-drop visua
4444

4545
See [this tutorial](api-management-howto-developer-portal-customize.md) for example customizations.
4646

47+
> [!NOTE]
48+
> The managed developer portal receives and applies updates automatically. Changes that you've saved but not published to the developer portal remain in that state during an update.
49+
4750
## <a name="managed-vs-self-hosted"></a> Extensibility
4851

4952
In some cases you might need functionality beyond the customization and styling options supported in the managed developer portal. If you need to implement custom logic, which isn't supported out-of-the-box, you can modify the portal's codebase, available on [GitHub](https://github.com/Azure/api-management-developer-portal). For example, you could create a new widget to integrate with a third-party support system. When you implement new functionality, you can choose one of the following options:

articles/api-management/import-soap-api.md

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,10 @@
11
---
22
title: Import SOAP API using the Azure portal | Microsoft Docs
33
description: Learn how to import a standard XML representation of a SOAP API, and then test the API in the Azure and Developer portals.
4-
services: api-management
5-
documentationcenter: ''
64
author: dlepow
7-
manager: cfowler
8-
editor: ''
9-
105
ms.service: api-management
11-
ms.workload: mobile
12-
ms.tgt_pltfrm: na
13-
ms.topic: article
14-
ms.date: 04/22/2020
6+
ms.topic: how-to
7+
ms.date: 02/10/2022
158
ms.author: danlep
169

1710
---
@@ -24,7 +17,6 @@ In this article, you learn how to:
2417
> [!div class="checklist"]
2518
> * Import SOAP API
2619
> * Test the API in the Azure portal
27-
> * Test the API in the Developer portal
2820
2921
## Prerequisites
3022

@@ -57,7 +49,7 @@ Complete the following quickstart: [Create an Azure API Management instance](get
5749
8. Enter other API settings. You can set the values during creation or configure them later by going to the **Settings** tab. The settings are explained in the [Import and publish your first API](import-and-publish.md#import-and-publish-a-backend-api) tutorial.
5850
9. Select **Create**.
5951

60-
### Test the new API in the administrative portal
52+
### Test the new API in the portal
6153

6254
Operations can be called directly from the administrative portal, which provides a convenient way to view and test the operations of an API.
6355

@@ -70,6 +62,18 @@ Operations can be called directly from the administrative portal, which provides
7062

7163
Backend responds with **200 OK** and some data.
7264

65+
## Wildcard SOAP action
66+
67+
If you need to pass a SOAP request that doesn't have a dedicated action defined in the API, you can configure a wildcard SOAP action. The wildcard action will match any SOAP request that isn't defined in the API.
68+
69+
To define a wildcard SOAP action:
70+
71+
1. In the portal, select the API you created in the previous step.
72+
1. In the **Design** tab, select **+ Add Operation**.
73+
1. Enter a **Display name** for the operation.
74+
1. In the URL, select `POST` and enter `/soapAction={any}` in the resource. The template parameter inside the curly brackets is arbitrary and doesn't affect the execution.
75+
76+
7377
[!INCLUDE [api-management-navigate-to-instance.md](../../includes/api-management-append-apis.md)]
7478

7579
[!INCLUDE [api-management-define-api-topics.md](../../includes/api-management-define-api-topics.md)]
Lines changed: 48 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Manually create and deploy an Azure Precept Devkit
2+
title: How to do a manual default container deployment to Azure Percept DK
33
description: this article shows the audience how to manually create and deploy an Azure Precept Devkit
44
author: nkhuyent
55
ms.author: keithke
@@ -10,71 +10,77 @@ ms.custom: template-how-to
1010
---
1111

1212

13-
# Manually create and deploy an Azure Precept Devkit
14-
The following guide is to help customers manually deploy a factory fresh IoT Edge deployment to existing Azure Percept devices. We have also included the steps to manually create your Azure Percept IoT Edge device instance.
13+
# How to do a manual default container deployment to Azure Percept DK
14+
15+
The following guide is to help customers manually deploy a factory fresh IoT Edge deployment to existing Azure Percept devices. We've also included the steps to manually create your Azure Percept IoT Edge device instance.
1516

1617
## Prerequisites
1718

18-
- Highly recommended: Update your Percept Devkit to the [latest version](./software-releases-usb-cable-updates.md)
19-
- Azure account with IoT Hub created
19+
- Highly recommended: Update your Azure Percept DK to the [latest version](./software-releases-usb-cable-updates.md)
20+
- Create an Azure account with an IoT Hub
2021
- Install [VSCode](https://code.visualstudio.com/Download)
2122
- Install the [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) Extension for VSCode
22-
- Find the software image version running on your Percept Devkit (see below).
23+
- Find the software image version running on your Azure Percept Devkit (see below)
2324

24-
## How to identify your Azure Percept Devkit software version
25+
## Identify your Azure Percept DK software version
2526

26-
SSH (Secure Shell) into your devkit and run the following command then write down the output for later reference.
27+
Using SSH (Secure Shell), run the command line below. Write down the output for later reference.
2728

2829
`cat /etc/adu-version`
2930

3031
Example output: 2021.111.124.109
3132

32-
## Create an Azure IoT Edge device for the Devkit
33-
If you have a device already created, you can skip to the [Manually deploy the deployment.json to the device](#manually-deploy-the-deploymentjson-to-the-azure-percept-device) section.
34-
1. Go to [Azure portal](https://portal.azure.com) and select the **IoT Hub** where you will create the device.
33+
## Create an Azure IoT Edge device for the Azure Percept DK
34+
If you already have an IoT Edge device instance created in your subscription for the devkit, you can skip to the [Manually deploy the deployment.json to the Azure Percept DK](#manually-deploy-the-deploymentjson-to-the-azure-percept-dk) section.
35+
1. Go to [Azure portal](https://portal.azure.com) and select the **IoT Hub** where you'll create the device
3536
2. Navigate to **IoT Edge** and select **Add an IoT Edge device**
36-
3. On the **Create a Device** screen, name your device in the **Device ID** section and leave all other fields as default, then click the **Save** button.
37-
![create new device](./media/manually-deploy-azure-precept-devkit-images/create-device.png)
37+
3. On the **Create a Device** screen, name your device in the **Device ID** section and leave all other fields as default, then select **Save**
38+
:::image type="content" source="./media/manually-deploy-azure-precept-devkit-images/create-device.png" alt-text="create new device":::
3839

39-
1. Select your newly created device.
40-
![select new device.](./media/manually-deploy-azure-precept-devkit-images/select-new-device.png)
40+
1. Select your newly created device
41+
:::image type="content" source="./media/manually-deploy-azure-precept-devkit-images/select-new-device.png" alt-text="select new device.":::
4142

42-
2. Copy the **Primary Connection String**. We will use this copied text in the Azure Percept Onboarding/setup web pages.
43-
![Primary Connection String](./media/manually-deploy-azure-precept-devkit-images/primary-connection-string.png)
43+
2. Copy the **Primary Connection String**, we will use this copied text in the Azure Percept Onboarding/setup web pages
44+
:::image type="content" source="./media/manually-deploy-azure-precept-devkit-images/primary-connection-string.png" alt-text="primary connection string.":::
4445

4546

46-
## Connect to and Setup the Devkit
47+
## Connect to and set up the Azure Percept DK
4748
<!-- Introduction paragraph -->
48-
1. Setup your Devkit using the main instructions and **STOP** at to the **Select your preferred configuration** page
49+
1. Set up your devkit using the main instructions and **STOP** at to the **Select your preferred configuration** page
4950
1. Select **Connect to an existing device**
50-
1. Paste the **Primary Connection String** that you copied from the earlier steps.
51-
2. Click Finish.
52-
3. The **Device setup complete!** page should now display.
51+
1. Paste the **Primary Connection String** that you copied from the earlier steps
52+
2. Select Finish
53+
3. The **Device set up complete!** page should now display
5354
**If this page does not disappear after 10 secs, don’t worry. Just go ahead with the next steps**
54-
4. You will be disconnected from the Devkit’s Wi-Fi hotspot. Reconnect your computer to your main Wi-Fi (if needed).
55-
56-
57-
## Manually deploy the deployment.json to the Azure Percept device
58-
The deployment.json files are a representation of all default modules necessary to begin using the Azure Percept devkit.
59-
1. Download the appropriate deployment.json from [GitHub](https://github.com/microsoft/azure-percept-advanced-development/tree/main/default-configuration) for your reported software version. Refer to the [How to Identify your Azure Percept Devkit software version](#how-to-identify-your-azure-percept-devkit-software-version) section above.
60-
1. For 2021.111.124.xxx and later -----> use [default-deployment-2112.json](https://github.com/microsoft/azure-percept-advanced-development/blob/main/default-configuration/default-deployment-2112.json)
61-
2. For 2021.109.129.xxx and lower use ----> use [default-deployment-2108.json](https://github.com/microsoft/azure-percept-advanced-development/blob/main/default-configuration/default-deployment-2108.json)
62-
2. Launch VSCode and Sign into Azure. Be sure you have installed the [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) Extension
63-
3. Connect to your subscription and select your IoTHub
64-
4. Locate your IoT Edge Device then right click it and choose **Create deployment for a Single Device**.
65-
![find edge device](./media/manually-deploy-azure-precept-devkit-images/iot-edge-device.png) ![create deployment for edge device](./media/manually-deploy-azure-precept-devkit-images/create-deployment.png)
66-
67-
5. Navigate to the "Deployment.json" you saved from step 1 and use this.
68-
6. Deployment will take 1-5 mins to fully complete.
69-
1. For those interested in watching the IoT Edge log as this deployment is going on, you can SSH into your Azure Percept devkit and watch the iotedge logs by issuing the command below.
55+
4. You'll be disconnected from the devkit’s Wi-Fi hotspot, reconnect your computer to your main Wi-Fi (if needed)
56+
57+
58+
## Manually deploy the deployment.json to the Azure Percept DK
59+
60+
The deployment.json files are a representation of all default modules necessary to begin using the Azure Percept DK.
61+
1. Download the appropriate deployment.json from [GitHub](https://github.com/microsoft/azure-percept-advanced-development/tree/main/default-configuration) for your reported software version. Refer to the [Identify your Azure Percept DK software version](#identify-your-azure-percept-dk-software-version) section above.
62+
1. For 2021.111.124.xxx and later, use [default-deployment-2112.json](https://github.com/microsoft/azure-percept-advanced-development/blob/main/default-configuration/default-deployment-2112.json)
63+
2. For 2021.109.129.xxx and lower, use [default-deployment-2108.json](https://github.com/microsoft/azure-percept-advanced-development/blob/main/default-configuration/default-deployment-2108.json)
64+
2. Launch VSCode and Sign into Azure. Be sure you've installed the [Azure IoT Tools](https://marketplace.visualstudio.com/items?itemName=vsciot-vscode.azure-iot-tools) Extension.
65+
66+
![Sign into Azure in VScode.](./media/manually-deploy-azure-precept-devkit-images/azure-sign-in.png)
67+
68+
3. Connect to your subscription and select your IoT Hub
69+
4. Locate your IoT Edge Device then right select it and choose **Create deployment for a Single Device**.
70+
71+
![find edge device.](./media/manually-deploy-azure-precept-devkit-images/iot-edge-device.png) ![create deployment for edge device](./media/manually-deploy-azure-precept-devkit-images/create-deployment.png)
72+
73+
5. Navigate to the "Deployment.json" you saved from step 1 and select it. Then select OK.
74+
6. Deployment will take 1-5 minutes to fully complete
75+
1. If you are interested in watching the Azure IoT Edge log while the deployment is going on, you can SSH into your Azure Percept DK and watch the Azure IoT Edge logs by issuing the command below.
7076
`sudo journalctl -u iotedge -f`
71-
7. Your Devkit is now ready to use!
77+
7. Your Azure Percept DK is now ready to use!
7278

7379

7480
<!-- 5. Next steps
75-
Required. Provide at least one next step and no more than three. Include some
76-
context so the customer can determine why they would click the link.
81+
@@ -77,4 +76,4 @@ context so the customer can determine why they would click the link.
7782
-->
7883

7984
## Next steps
80-
Navigate to the [Azure Percept portal](https://portal.azure.com/#blade/AzureEdgeDevices/Main/overview) for more AI models.
85+
Navigate to the [Azure Percept Studio](https://ms.portal.azure.com/#blade/AzureEdgeDevices/Main/overview) for more AI models.
86+

0 commit comments

Comments
 (0)