Compartilhar via


Gerenciamento do Microsoft.ManagementGroups 2019-11-01

Definição de recurso do Bicep

O tipo de recurso managementGroups é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a scope propriedade nesse recurso para definir o escopo desse recurso. Consulte Definir escopo em recursos de extensão no Bicep.

O tipo de recurso managementGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Comentários

Quando implantado no escopo do locatário, não defina a propriedade de escopo. Consulte criar grupos de gerenciamento com implantações de locatário no arquivo Bicep ou modelos do ARM.

Quando implantado em outros escopos, defina a propriedade tenant() de escopo como para arquivos Bicep ou / para modelos do ARM. Consulte criar grupos de gerenciamento com implantações de grupo de gerenciamento em arquivos Bicep ou modelos do ARM.

Formato de recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.Management/managementGroups@2019-11-01' = {
  name: 'string'
  scope: tenant()
  properties: {
    details: {
      parent: {
        id: 'string'
      }
    }
    displayName: 'string'
  }
}

Valores de propriedade

managementGroups

Nome Descrição Valor
name O nome do recurso cadeia de caracteres (obrigatório)
scope Use ao criar um recurso de extensão em um escopo diferente do escopo de implantação. Para Bicep: tenant().
properties As propriedades genéricas de um grupo de gerenciamento usado durante a criação. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Nome Descrição Valor
detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
displayName O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, esse campo será definido como groupId. string

CreateManagementGroupDetailsOrManagementGroupDetails

Nome Descrição Valor
pai (Opcional) A ID do grupo de gerenciamento pai usado durante a criação. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Nome Descrição Valor
id A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000 string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar um novo grupo de gerenciamento

Implantar no Azure
Esse modelo é um modelo de nível de locatário que criará um novo grupo de gerenciamento.

Definição de recurso de modelo do ARM

O tipo de recurso managementGroups é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a scope propriedade nesse recurso para definir o escopo desse recurso. Consulte Definir escopo em recursos de extensão em modelos do ARM.

O tipo de recurso managementGroups pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Comentários

Quando implantado no escopo do locatário, não defina a propriedade de escopo. Consulte criar grupos de gerenciamento com implantações de locatário no arquivo Bicep ou modelos do ARM.

Quando implantado em outros escopos, defina a propriedade tenant() de escopo como para arquivos Bicep ou / para modelos do ARM. Consulte criar grupos de gerenciamento com implantações de grupo de gerenciamento em arquivos Bicep ou modelos do ARM.

Formato de recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Management/managementGroups",
  "apiVersion": "2019-11-01",
  "name": "string",
  "scope": "/",
  "properties": {
    "details": {
      "parent": {
        "id": "string"
      }
    },
    "displayName": "string"
  }
}

Valores de propriedade

managementGroups

Nome Descrição Valor
tipo O tipo de recurso 'Microsoft.Management/managementGroups'
apiVersion A versão da API de recursos '2019-11-01'
name O nome do recurso cadeia de caracteres (obrigatório)
scope Use ao criar um recurso de extensão em um escopo diferente do escopo de implantação. Para JSON: /.
properties As propriedades genéricas de um grupo de gerenciamento usado durante a criação. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Nome Descrição Valor
detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
displayName O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, esse campo será definido como groupId. string

CreateManagementGroupDetailsOrManagementGroupDetails

Nome Descrição Valor
pai (Opcional) A ID do grupo de gerenciamento pai usado durante a criação. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Nome Descrição Valor
id A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000 string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar um novo grupo de gerenciamento

Implantar no Azure
Esse modelo é um modelo de nível de locatário que criará um novo grupo de gerenciamento.

Definição de recurso do Terraform (provedor AzAPI)

O tipo de recurso managementGroups é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a parent_id propriedade nesse recurso para definir o escopo desse recurso.

O tipo de recurso managementGroups pode ser implantado com operações direcionadas:

  • Inquilinos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o Terraform a seguir ao modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Management/managementGroups@2019-11-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      details = {
        parent = {
          id = "string"
        }
      }
      displayName = "string"
    }
  })
}

Valores de propriedade

managementGroups

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Management/managementGroups@2019-11-01"
name O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
properties As propriedades genéricas de um grupo de gerenciamento usado durante a criação. CreateManagementGroupPropertiesOrManagementGroupProp...

CreateManagementGroupPropertiesOrManagementGroupProp...

Nome Descrição Valor
detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
displayName O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, esse campo será definido como groupId. string

CreateManagementGroupDetailsOrManagementGroupDetails

Nome Descrição Valor
pai (Opcional) A ID do grupo de gerenciamento pai usado durante a criação. CreateParentGroupInfoOrParentGroupInfo

CreateParentGroupInfoOrParentGroupInfo

Nome Descrição Valor
id A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000 string