Management Groups - Create Or Update

Referencia

Servicio:: Management Groups

Versión de la API:: 2020-05-01

Crea o actualiza un grupo de administración. Si ya se ha creado un grupo de administración y se emite una solicitud de creación posterior con propiedades diferentes, se actualizarán las propiedades del grupo de administración.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
groupId	path	True	string	Identificador del grupo de administración.
api-version	query	True	string	Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2018-01-01-preview.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Cache-Control		string	Indica que la solicitud no debe usar ninguna memoria caché.

Cuerpo de la solicitud

Nombre	Tipo	Description
name	string	Nombre del grupo de administración. Por ejemplo, 00000000-0000-0000-0000-00000000000000
properties.details	CreateManagementGroupDetails	Detalles Detalles de un grupo de administración utilizado durante la creación.
properties.displayName	string	Nombre descriptivo del grupo de administración. Si no se pasa ningún valor, este campo se establecerá en el groupId.

Respuestas

Nombre	Tipo	Description
200 OK	ManagementGroup	Aceptar
202 Accepted	AzureAsyncOperationResults	Aceptado Encabezados Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Error

Nombre

Tipo

Description

200 OK

ManagementGroup

Aceptar

202 Accepted

AzureAsyncOperationResults

Aceptado

Encabezados

Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Error

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

PutManagementGroup

Solicitud de ejemplo

HTTP

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


{
  "properties": {
    "displayName": "ChildGroup",
    "details": {
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup"
      }
    }
  }
}

Respuesta de muestra

status code:: 200

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "displayName": "ChildGroup",
    "details": {
      "version": 1,
      "updatedTime": "2018-01-01T00:00:00.00Z",
      "updatedBy": "16b8ef21-5c9f-420c-bcc9-e4f8c9f30b4b",
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup",
        "name": "RootGroup",
        "displayName": "RootGroup"
      }
    }
  }
}

status code:: 202

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "status": "NotStarted"
}

Definiciones

Nombre	Description
AzureAsyncOperationResults	Los resultados de Azure-AsyncOperation.
CreateManagementGroupChildInfo	Información secundaria de un grupo de administración utilizado durante la creación.
CreateManagementGroupDetails	Detalles de un grupo de administración utilizado durante la creación.
CreateManagementGroupRequest	Parámetros de creación de grupos de administración.
CreateParentGroupInfo	(Opcional) Identificador del grupo de administración primario usado durante la creación.
ErrorDetails	Detalles del error.
ErrorResponse	Objeto de error.
ManagementGroup	Detalles del grupo de administración.
ManagementGroupChildInfo	Información secundaria de un grupo de administración.
ManagementGroupChildType	Tipo de recurso secundario.
ManagementGroupDetails	Detalles de un grupo de administración.
ManagementGroupPathElement	Elemento path de los antecesores de un grupo de administración.
ParentGroupInfo	(Opcional) Identificador del grupo de administración primario.

AzureAsyncOperationResults

Los resultados de Azure-AsyncOperation.

Nombre	Tipo	Description
id	string	Identificador completo del grupo de administración. Por ejemplo, /providers/Microsoft.Management/managementGroups/00000000-0000-0000-00000-0000000000000
name	string	Nombre del grupo de administración. Por ejemplo, 00000000-0000-0000-0000-00000000000000
properties.displayName	string	Nombre descriptivo del grupo de administración.
properties.tenantId	string	Identificador de inquilino de AAD asociado al grupo de administración. Por ejemplo, 00000000-0000-0000-0000-00000000000000
status	string	Estado actual de la operación asincrónica realizada. Por ejemplo, Running, Succeeded, Failed
type	string	Tipo de recurso. Por ejemplo, Microsoft.Management/managementGroups

CreateManagementGroupChildInfo

Información secundaria de un grupo de administración utilizado durante la creación.

Nombre	Tipo	Description
children	CreateManagementGroupChildInfo[]	Lista de elementos secundarios.
displayName	string	Nombre descriptivo del recurso secundario.
id	string	Identificador completo del recurso secundario (grupo de administración o suscripción). Por ejemplo, /providers/Microsoft.Management/managementGroups/00000000-0000-0000-00000-0000000000000
name	string	Nombre de la entidad secundaria.
type	ManagementGroupChildType	Tipo de recurso secundario. El tipo de recurso completo que incluye el espacio de nombres del proveedor (por ejemplo, Microsoft.Management/managementGroups)

CreateManagementGroupDetails

Detalles de un grupo de administración utilizado durante la creación.

Nombre	Tipo	Description
parent	CreateParentGroupInfo	Parent (Opcional) Identificador del grupo de administración primario usado durante la creación.
updatedBy	string	Identidad de la entidad de seguridad o proceso que actualizó el objeto.
updatedTime	string	Fecha y hora en que se actualizó por última vez este objeto.
version	number	Número de versión del objeto.

CreateManagementGroupRequest

Parámetros de creación de grupos de administración.

Nombre	Tipo	Description
id	string	Identificador completo del grupo de administración. Por ejemplo, /providers/Microsoft.Management/managementGroups/00000000-0000-0000-00000-0000000000000
name	string	Nombre del grupo de administración. Por ejemplo, 00000000-0000-0000-0000-00000000000000
properties.children	CreateManagementGroupChildInfo[]	Lista de elementos secundarios.
properties.details	CreateManagementGroupDetails	Detalles Detalles de un grupo de administración utilizado durante la creación.
properties.displayName	string	Nombre descriptivo del grupo de administración. Si no se pasa ningún valor, este campo se establecerá en el groupId.
properties.tenantId	string	Identificador de inquilino de AAD asociado al grupo de administración. Por ejemplo, 00000000-0000-0000-0000-00000000000000
type	string	Tipo de recurso. Por ejemplo, Microsoft.Management/managementGroups

CreateParentGroupInfo

(Opcional) Identificador del grupo de administración primario usado durante la creación.

Nombre	Tipo	Description
displayName	string	Nombre descriptivo del grupo de administración primario.
id	string	Identificador completo del grupo de administración primario. Por ejemplo, /providers/Microsoft.Management/managementGroups/00000000-0000-0000-00000-0000000000000
name	string	Nombre del grupo de administración primario

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Uno de los conjuntos de códigos de error definidos por el servidor.
details	string	Representación legible de los detalles del error.
message	string	Representación legible del error.

ErrorResponse

Objeto de error.

Nombre	Tipo	Description
error	ErrorDetails	Error Detalles del error.