|
1 | 1 | --- |
2 | | -title: Deploy & manage Azure Container Instances |
3 | | -description: Automate tasks and workflows that create and manage container deployments in Azure Container Instances by using Azure Logic Apps. |
| 2 | +title: Connect to Azure Container Instances |
| 3 | +description: Learn how to automate container deployments in Azure Container Instances by using Azure Logic Apps. Build workflows to create, manage, and optimize containers. |
4 | 4 | services: logic-apps, container-instances |
5 | 5 | ms.service: azure-logic-apps |
6 | 6 | ms.suite: integration |
7 | | -author: dlepow |
8 | | -ms.author: danlep |
9 | | -ms.manager: gwallace |
10 | | -ms.reviewer: estfan, macolso |
| 7 | +ms.reviewers: estfan, azla |
11 | 8 | ms.topic: how-to |
12 | | -ms.date: 01/04/2024 |
| 9 | +ms.date: 02/24/2026 |
13 | 10 | ms.custom: sfi-image-nochange |
| 11 | +#Customer intent: As an integration developer who works with Azure Logic Apps, I want to connect, create, and manage container deployments in Azure Container Instances by building automation workflows in Azure Logic Apps. |
14 | 12 | --- |
15 | 13 |
|
16 | | -# Deploy and manage Azure Container Instances by using Azure Logic Apps |
| 14 | +# Create and manage container deployments in Azure Container Instances by using Azure Logic Apps |
17 | 15 |
|
18 | | -[!INCLUDE [logic-apps-sku-consumption](~/reusable-content/ce-skilling/azure/includes/logic-apps-sku-consumption.md)] |
| 16 | +[!INCLUDE [logic-apps-sku-consumption-standard](../../includes/logic-apps-sku-consumption-standard.md)] |
19 | 17 |
|
20 | | -With Azure Logic Apps and the Azure Container Instance connector, you can set up automated tasks and workflows that deploy and manage [container groups](/azure/container-instances/container-instances-container-groups). The Container Instance connector supports the following actions: |
| 18 | +When you need to automate container deployments, build a logic app workflow that uses the Azure Container Instance connector in Azure Logic Apps. For example, automate tasks such as deploying and managing [container groups](/azure/container-instances/container-instances-container-groups), retrieving properties, or accessing logs. The following list includes other tasks you can automate: |
21 | 19 |
|
22 | | -* Create or delete a container group |
23 | | -* Get the properties of a container group |
24 | | -* Get a list of container groups |
25 | | -* Get the logs of a container instance |
| 20 | +- Create, update, or delete a container group and container instances. |
| 21 | +- Get the properties from a container group. |
| 22 | +- Get a list of container groups. |
| 23 | +- Get the logs for a container instance. |
26 | 24 |
|
27 | | -Use these actions in your logic apps for tasks such as running a container workload in response to a Logic Apps trigger. You can also have other actions use the output from Container Instance actions. |
| 25 | +You can also use the output from these actions in other workflow actions. |
28 | 26 |
|
29 | | -This connector provides only actions, so to start your logic app, |
30 | | -use a separate trigger, such as a **Recurrence** trigger to run a container workload on a regular schedule. Or, you might have need to trigger a container group deployment after an event such as arrival of an Outlook e-mail. |
31 | | - |
32 | | -If you're new to logic apps, review |
33 | | -[What is Azure Logic Apps?](../logic-apps/logic-apps-overview.md) |
| 27 | +This guide shows how to add an Azure Container Instance action to your workflow. |
34 | 28 |
|
35 | 29 | ## Prerequisites |
36 | 30 |
|
37 | | -* An Azure account and subscription. If you don't have an Azure subscription, |
38 | | -[sign up for a free Azure account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). |
| 31 | +- An Azure account and subscription. [Get a free Azure account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). |
| 32 | + |
| 33 | +- The container group with the container instance to connect from your workflow. |
| 34 | + |
| 35 | + For more information, see [Quickstart: Deploy a container instance in Azure using the Azure portal](/azure/container-instances/container-instances-quickstart-portal). |
| 36 | + |
| 37 | +- The logic app workflow from where you want to access your container instance. |
39 | 38 |
|
40 | | -* Basic knowledge about how to create logic apps and how to create container instances |
| 39 | + The Azure Container Instance connector provides only actions, so your workflow needs to start with a trigger that best suits your business scenario. For example, to run a container workload on a schedule, use the **Recurrence** trigger. Or, to deploy a container group after a specific event, such as when the workflow receives an email in Outlook, use the trigger named **When a new email arrives**. For simplicity, this example uses the **Recurrence** trigger. |
41 | 40 |
|
42 | | - * [Create an example Consumption logic app workflow](../logic-apps/quickstart-create-example-consumption-workflow.md) |
| 41 | + To add a trigger to your workflow, follow the [general steps](../logic-apps/add-trigger-action-workflow.md#add-trigger) for the trigger you want. Set up the corresponding connection, if necessary. |
43 | 42 |
|
44 | | - * [Create and manage container instances](/azure/container-instances/container-instances-quickstart) |
| 43 | + For more information, see: |
45 | 44 |
|
46 | | -* The logic app where you want to access your container instances. To use an action, start your logic app with another trigger, for example, the **Recurrence** trigger. |
| 45 | + - [Create a Consumption logic app workflow](../logic-apps/quickstart-create-example-consumption-workflow.md) |
47 | 46 |
|
48 | | -## Add a Container Instance action |
| 47 | + - [Create a Standard logic app workflow](../logic-apps/create-single-tenant-workflows-azure-portal.md) |
49 | 48 |
|
50 | | -[!INCLUDE [Create connection general intro](../../includes/connectors-create-connection-general-intro.md)] |
| 49 | +## Connector technical reference |
51 | 50 |
|
52 | | -1. Sign in to the [Azure portal](https://portal.azure.com), |
53 | | -and open your logic app in Logic App Designer, if not open already. |
| 51 | +For more information about the operations and limits for this connector, see the connector's [reference page](/connectors/aci/) or container group [YAML reference](/azure/container-instances/container-instances-reference-yaml). |
54 | 52 |
|
55 | | -1. Choose a path: |
| 53 | +## Add an Azure Container Instance connector action |
56 | 54 |
|
57 | | - * Under the last step where you want to add an action, |
58 | | - choose **New step**. |
| 55 | +This section shows how to add an Azure Container Instance connector action to a workflow that already starts with a trigger. |
59 | 56 |
|
60 | | - -or- |
| 57 | +1. In the [Azure portal](https://portal.azure.com), open your logic app resource and workflow in the designer. |
61 | 58 |
|
62 | | - * Between the steps where you want to add an action, |
63 | | - move your pointer over the arrow between steps. |
64 | | - Choose the plus sign (**+**) that appears, |
65 | | - and then select **Add an action**. |
| 59 | +1. Under the trigger, add the Azure Container Instance connector action you want by following the [general steps](../logic-apps/add-trigger-action-workflow.md#add-action). |
66 | 60 |
|
67 | | -1. In the search box, enter "container instance" as your filter. |
68 | | -Under the actions list, select the Azure Container Instance connector action you want. |
| 61 | + This example adds the action named **Create or update a container group**. |
69 | 62 |
|
70 | | -1. Provide a name for your connection. |
| 63 | +1. After the connection information pane opens, select the required **Authentication** type, and provide the corresponding information as prompted. |
71 | 64 |
|
72 | | -1. Provide the necessary details for your selected action |
73 | | -and continue building your logic app's workflow. |
| 65 | +1. Provide the following information about the container group and one or more container instances in the group, for example: |
74 | 66 |
|
75 | | - For example, select **Create container group** and enter the properties for a container group and one or more container instances in the group, as shown in the following image (partial detail): |
| 67 | + | Parameter | Description | |
| 68 | + |-----------|-------------| |
| 69 | + | **Subscription Id** | The Azure subscription for your container group. | |
| 70 | + | **Resource Group** | The Azure resource group for your container group. | |
| 71 | + | **Container Group Name** | The name for your container group. |
| 72 | + | **Container Group Location** | The Azure region for your container group. | |
| 73 | + | **ContainerGroup containers** | One or more container instances in your container group. | |
76 | 74 |
|
77 | | -  |
| 75 | + The following screenshot shows an example: |
78 | 76 |
|
79 | | -## Connector reference |
| 77 | + :::image type="content" source="./media/connectors-create-api-container-instances/create-update-container-group.png" alt-text="Screenshot that shows the Azure portal, workflow designer, and selected action. Action pane shows information for the container group and container instances to create or update."::: |
80 | 78 |
|
81 | | -For technical details about triggers, actions, and limits, which are |
82 | | -described by the connector's OpenAPI (formerly Swagger) description, |
83 | | -review the connector's [reference page](/connectors/aci/) or container group [YAML reference](/azure/container-instances/container-instances-reference-yaml). |
| 79 | +1. Save your workflow. On the designer toolbar, select **Save**. |
84 | 80 |
|
85 | | -## Next steps |
| 81 | +1. Continue adding actions to your workflow, if necessary. |
86 | 82 |
|
87 | | -* See a [sample logic app](https://github.com/Azure-Samples/aci-logicapps-integration) that runs a container in Azure Container Instances to analyze the sentiment of e-mail or X text |
| 83 | +## Sample |
88 | 84 |
|
89 | | -* [Managed connectors for Azure Logic Apps](managed.md) |
| 85 | +For a sample that analyzes the sentiment of an email, see the [sample logic app](https://github.com/Azure-Samples/aci-logicapps-integration) that runs a container in Azure Container Instances. |
90 | 86 |
|
91 | | -* [Built-in connectors for Azure Logic Apps](built-in.md) |
| 87 | +## Related content |
92 | 88 |
|
93 | | -* [What are connectors in Azure Logic Apps](introduction.md) |
| 89 | +- [Connectors in Azure Logic Apps](introduction.md) |
0 commit comments