Compartilhar via


Hierarchy Settings - Get

Obtém as configurações de hierarquia definidas no nível do Grupo de Gerenciamento. As configurações só podem ser definidas no Grupo de Gerenciamento raiz da hierarquia.

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

Parâmetros de URI

Nome Em Obrigatório Tipo 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.

Respostas

Nome Tipo Description
200 OK

HierarchySettings

OK

Other Status Codes

ErrorResponse

Erro

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

GetGroupSettings

Solicitação de exemplo

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

Resposta de exemplo

{
  "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

Nome Description
ErrorDetails

Os detalhes do erro.

ErrorResponse

O objeto de erro.

HierarchySettings

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

ErrorDetails

Os detalhes do erro.

Nome Tipo Description
code

string

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

details

string

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

message

string

Uma representação legível do erro.

ErrorResponse

O objeto de erro.

Nome Tipo Description
error

ErrorDetails

Erro
Os detalhes do erro.

HierarchySettings

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

Nome Tipo Description
id

string

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

name

string

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

properties.defaultManagementGroup

string

Configurações que definem o Grupo de Gerenciamento padrão no qual novas assinaturas são adicionadas a esse 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 do Grupo de Gerenciamento raiz 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-0000000000000

type

string

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