---
title: Azure RM - ACS
slug: homologacao-atmosphere/azure-rm-acs
description: Learn how to create, update, and delete an instance of Azure Container Service (ACS) with this comprehensive document. Discover the essential parameters needed for creating an ACS instance, including agent pool profiles, diagnostics profile, Linux profile
docTags: 
createdAt: 2021-06-30T11:09:47.000Z
---

## Resumo

- Crie, atualize e exclua uma instância do Azure Container Service (ACS).

## Parâmetros

| **Parâmetro**                        | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários**                                                                                                                                                         |
| ------------------------------------ | -------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| agent\_pool\_profiles - *required*   |          |                              | The agent pool profile suboptions.                                                                                                                                      |
| diagnostics\_profile - *required*    | boolean  |                              | Should VM Diagnostics be enabled for the Container Service VM's.                                                                                                        |
| linux\_profile - *required*          |          |                              | The Linux profile suboptions.                                                                                                                                           |
| location                             |          |                              | Valid azure location. Defaults to location of the resource group.                                                                                                       |
| master\_profile - *required*         |          |                              | Master profile suboptions.                                                                                                                                              |
| name - *required*                    | string   |                              | Name of the Azure Container Services(ACS) instance.                                                                                                                     |
| orchestration\_platform - *required* |          |                              | Specifies the Container Orchestration Platform to use. Currently can be either DCOS, Kubernetes or Swarm.The *service\_principal* must be defined if set to Kubernetes. |
| resource\_group - *required*         |          |                              | Name of a resource group where the Container Services exists or will be created.                                                                                        |
| service\_principal                   |          |                              | The service principal suboptions.Required when *orchestration\_platform=Kubernetes*.                                                                                    |
| state                                | string   |                              | Assert the state of the ACS. Use present to create or update an ACS and absent to delete it.                                                                            |



| **Parâmetro**            | **Escolhas \| Valor Padrão** | **Comentários**                                                                                                |
| ------------------------ | ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
| count - / required       |                              | Number of agents (VMs) to host docker containers. Allowed values must be in the range of 1 to 100 (inclusive). |
| dns\_prefix - / required |                              | The DNS Prefix given to Agents in this Agent Pool.                                                             |
| name - / required        |                              | Unique name of the agent pool profile in the context of the subscription and resource group.                   |
| vm\_size - / required    |                              | The VM Size of each of the Agent Pool VM's (e.g. Standard\_F1 / Standard\_D2v2).                               |



| **Parâmetro**                | **Escolhas \| Valor Padrão** | **Comentários**                                |
| ---------------------------- | ---------------------------- | ---------------------------------------------- |
| admin\_username - / required |                              | The Admin Username for the Cluster.            |
| ssh\_key - / required        |                              | The Public SSH Key used to access the cluster. |



| **Parâmetro**                     | **Escolhas \| Valor Padrão** | **Comentários**                                                                           |
| --------------------------------- | ---------------------------- | ----------------------------------------------------------------------------------------- |
| count - / required                |                              | Number of masters (VMs) in the container service cluster. Allowed values are 1, 3, and 5. |
| dns\_prefix - / required          |                              | The DNS Prefix to use for the Container Service master nodes.                             |
| vm\_size - / requiredadded in 2.5 |                              | The VM Size of each of the Agent Pool VM's (e.g. Standard\_F1 / Standard\_D2v2).          |



| **Parâmetro**    | **Escolhas \| Valor Padrão** | **Comentários**                                            |
| ---------------- | ---------------------------- | ---------------------------------------------------------- |
| client\_id -     |                              | The ID for the Service Principal.                          |
| client\_secret - |                              | The secret password associated with the service principal. |

## Exemplos

```javascript
```

## Valores Retornados

| ChaveDevolvidaDescrição |        |                                                      |
| ----------------------- | ------ | ---------------------------------------------------- |
| Estado dicionário       | sempre | Estado atual do Azure Container Service (ACS).<br /> |




