Compartilhar via


Hierarchy Settings - List

Obtém todas 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?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

HierarchySettingsList

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

ListGroupSettings

Solicitação de exemplo

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

Resposta de exemplo

{
  "value": [
    {
      "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
      }
    }
  ],
  "@nextLink": null
}

Definições

Nome Description
ErrorDetails

Os detalhes do erro.

ErrorResponse

O objeto de erro.

HierarchySettingsInfo

O recurso de configurações de hierarquia.

HierarchySettingsList

Listas todas as configurações de hierarquia.

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 por humanos dos detalhes do erro.

message

string

Uma representação legível pelo homem do erro.

ErrorResponse

O objeto de erro.

Nome Tipo Description
error

ErrorDetails

Erro
Os detalhes do erro.

HierarchySettingsInfo

O recurso de configurações de hierarquia.

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-000000000000000/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 sob o 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 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, 000000000-0000-0000-0000-0000000000000

type

string

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

HierarchySettingsList

Listas todas as configurações de hierarquia.

Nome Tipo Description
@nextLink

string

A URL a ser usada para obter o próximo conjunto de resultados.

value

HierarchySettingsInfo[]

A lista de configurações de hierarquia.