Partilhar via


Hierarchy Settings - List

Obtém todas as definições de hierarquia definidas ao nível do Grupo de Gestão. As definições só podem ser definidas no Grupo de Gestão raiz da hierarquia.

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

Parâmetros do URI

Name Em Necessário Tipo Description
groupId
path True

string

ID do Grupo de Gestão.

api-version
query True

string

Versão da API a utilizar com o pedido de cliente. A versão atual é 2018-01-01-preview.

Respostas

Name Tipo Description
200 OK

HierarchySettingsList

OK

Other Status Codes

ErrorResponse

Erro

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

ListGroupSettings

Pedido de amostra

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

Resposta da amostra

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

Name Description
ErrorDetails

Os detalhes do erro.

ErrorResponse

O objeto de erro.

HierarchySettingsInfo

O recurso de definições de hierarquia.

HierarchySettingsList

Listas todas as definições de hierarquia.

ErrorDetails

Os detalhes do erro.

Name Tipo Description
code

string

Um dos conjuntos de códigos de erro definidos pelo servidor.

details

string

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

message

string

Uma representação legível por humanos do erro.

ErrorResponse

O objeto de erro.

Name Tipo Description
error

ErrorDetails

Erro
Os detalhes do erro.

HierarchySettingsInfo

O recurso de definições de hierarquia.

Name Tipo Description
id

string

O ID completamente qualificado para o objeto de definições. Por exemplo, /providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000000/settings/default.

name

string

O nome do objeto. Neste caso, predefinição.

properties.defaultManagementGroup

string

Definições que definem o Grupo de Gestão predefinido ao abrigo do qual são adicionadas novas subscrições neste inquilino. 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 Gestão de raiz. Se estiver definido como verdadeiro, o utilizador exigirá a ação Microsoft.Management/managementGroups/write no âmbito do Grupo de Gestão de raiz para criar novos Grupos diretamente na raiz. Isto impedirá os novos utilizadores de criarem novos Grupos de Gestão, a menos que lhes seja concedido acesso.

properties.tenantId

string

O ID do Inquilino do AAD associado às definições da hierarquia. Por exemplo, 000000000-0000-0000-0000-0000000000000

type

string

O tipo de recurso. Por exemplo, Microsoft.Management/managementGroups/settings.

HierarchySettingsList

Listas todas as definições de hierarquia.

Name Tipo Description
@nextLink

string

O URL a utilizar para obter o próximo conjunto de resultados.

value

HierarchySettingsInfo[]

A lista de definições de hierarquia.