Hierarchy Settings - Create Or Update

Cria ou atualiza as configurações de hierarquia definidas no nível do Grupo de Gerenciamento.

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/settings/default?api-version=2020-05-01

Parâmetros de URI

Name In Required Type Description
groupId
path True
  • string

ID do Grupo de Gerenciamento.

api-version
query True
  • string

Versão da API a ser usada com a solicitação do cliente. A versão atual é 2018-01-01-preview.

Corpo da solicitação

Name Type Description
properties.defaultManagementGroup
  • string

Configurações que define o Grupo de Gerenciamento padrão no qual novas assinaturas são adicionadas nesse locatário. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation
  • boolean

Indica se o acesso rbac é necessário após a criação do grupo no Grupo de Gerenciamento raiz. Se definido como true, o usuário exigirá a ação Microsoft.Management/managementGroups/write no escopo raiz do Grupo de Gerenciamento para criar novos Grupos diretamente na raiz. Isso impedirá que novos usuários criem novos Grupos de Gerenciamento, a menos que tenham acesso.

Respostas

Name Type Description
200 OK

OK

Other Status Codes

Erro

Segurança

azure_auth

Azure Active Directory Flow OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

GetGroupSettings

Sample Request

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/root/settings/default?api-version=2020-05-01

{
  "properties": {
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Sample Response

{
  "id": "/providers/Microsoft.Management/managementGroups/root/settings/default",
  "type": "Microsoft.Management/managementGroups/settings",
  "name": "root",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Definições

CreateOrUpdateSettingsRequest

Parâmetros para criar ou atualizar as configurações do Grupo de Gerenciamento

ErrorDetails

Os detalhes do erro.

ErrorResponse

O objeto de erro.

HierarchySettings

Configurações definido no escopo do Grupo de Gerenciamento.

CreateOrUpdateSettingsRequest

Parâmetros para criar ou atualizar as configurações do Grupo de Gerenciamento

Name Type Description
properties.defaultManagementGroup
  • string

Configurações que define o Grupo de Gerenciamento padrão no qual novas assinaturas são adicionadas nesse locatário. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation
  • boolean

Indica se o acesso rbac é necessário após a criação do grupo no Grupo de Gerenciamento raiz. Se definido como true, o usuário exigirá a ação Microsoft.Management/managementGroups/write no escopo raiz do Grupo de Gerenciamento para criar novos Grupos diretamente na raiz. Isso impedirá que novos usuários criem novos Grupos de Gerenciamento, a menos que tenham acesso.

ErrorDetails

Os detalhes do erro.

Name Type Description
code
  • string

Um de um conjunto definido pelo servidor de códigos de erro.

details
  • string

Uma representação legível pelos humanos dos detalhes do erro.

message
  • string

Uma representação legível do erro.

ErrorResponse

O objeto de erro.

Name Type Description
error

Erro
Os detalhes do erro.

HierarchySettings

Configurações definido no escopo do Grupo de Gerenciamento.

Name Type Description
id
  • string

A ID totalmente qualificada para o objeto de configurações. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000/settings/default.

name
  • string

O nome do objeto. Nesse caso, padrão.

properties.defaultManagementGroup
  • string

Configurações que define o Grupo de Gerenciamento padrão no qual novas assinaturas são adicionadas nesse locatário. Por exemplo, /providers/Microsoft.Management/managementGroups/defaultGroup

properties.requireAuthorizationForGroupCreation
  • boolean

Indica se o acesso rbac é necessário após a criação do grupo no Grupo de Gerenciamento raiz. Se definido como true, o usuário exigirá a ação Microsoft.Management/managementGroups/write no escopo raiz do Grupo de Gerenciamento para criar novos Grupos diretamente na raiz. Isso impedirá que novos usuários criem novos Grupos de Gerenciamento, a menos que tenham acesso.

properties.tenantId
  • string

A ID do Locatário do AAD associada às configurações de hierarquia. Por exemplo, 00000000-0000-0000-0000-00000000000

type
  • string

Tipo do recurso. Por exemplo, Microsoft.Management/managementGroups/settings.