Partilhar via


Microsoft.Management managementGroups

Comentários

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

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

Definição de recursos do bíceps

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

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

Formato do recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Management/managementGroups@2024-02-01-preview' = {
  scope: resourceSymbolicName or scope
  name: 'string'
  properties: {
    details: {
      parent: {
        id: 'string'
      }
    }
    displayName: 'string'
  }
}

Valores de propriedade

Microsoft.Management/managementGroups

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
propriedades As propriedades genéricas de um grupo de gerenciamento usadas durante a criação. CreateManagementGroupPropertiesOrManagementGroupProperties
âmbito Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

CreateManagementGroupDetailsOrManagementGroupDetails

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

CreateManagementGroupPropertiesOrManagementGroupProperties

Designação Descrição Valor
detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
nome de exibição O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, este campo será definido como groupId. cadeia (de caracteres)

CreateParentGroupInfoOrParentGroupInfo

Designação Descrição Valor
ID A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 cadeia (de caracteres)

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Módulo Descrição
Grupo de Gestão Módulo de recursos AVM para grupo de gerenciamento

Definição de recurso de modelo ARM

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

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

Formato do recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Management/managementGroups",
  "apiVersion": "2024-02-01-preview",
  "name": "string",
  "properties": {
    "details": {
      "parent": {
        "id": "string"
      }
    },
    "displayName": "string"
  }
}

Valores de propriedade

Microsoft.Management/managementGroups

Designação Descrição Valor
Versão da API A versão api '2024-02-01-pré-visualização'
Designação O nome do recurso string (obrigatório)
propriedades As propriedades genéricas de um grupo de gerenciamento usadas durante a criação. CreateManagementGroupPropertiesOrManagementGroupProperties
tipo O tipo de recurso 'Microsoft.Management/managementGroups'

CreateManagementGroupDetailsOrManagementGroupDetails

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

CreateManagementGroupPropertiesOrManagementGroupProperties

Designação Descrição Valor
detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
nome de exibição O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, este campo será definido como groupId. cadeia (de caracteres)

CreateParentGroupInfoOrParentGroupInfo

Designação Descrição Valor
ID A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 cadeia (de caracteres)

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Modelo Descrição
Criar um novo grupo de gerenciamento

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

Definição de recursos Terraform (provedor AzAPI)

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

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

Formato do recurso

Para criar um recurso Microsoft.Management/managementGroups, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Management/managementGroups@2024-02-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      details = {
        parent = {
          id = "string"
        }
      }
      displayName = "string"
    }
  }
}

Valores de propriedade

Microsoft.Management/managementGroups

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades As propriedades genéricas de um grupo de gerenciamento usadas durante a criação. CreateManagementGroupPropertiesOrManagementGroupProperties
tipo O tipo de recurso "Microsoft.Management/managementGroups@2024-02-01-preview"

CreateManagementGroupDetailsOrManagementGroupDetails

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

CreateManagementGroupPropertiesOrManagementGroupProperties

Designação Descrição Valor
detalhes Os detalhes de um grupo de gerenciamento usado durante a criação. CreateManagementGroupDetailsOrManagementGroupDetails
nome de exibição O nome amigável do grupo de gerenciamento. Se nenhum valor for passado, este campo será definido como groupId. cadeia (de caracteres)

CreateParentGroupInfoOrParentGroupInfo

Designação Descrição Valor
ID A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 cadeia (de caracteres)