Management Groups - Update

Referencia

Servicio:: Management Groups

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

Actualizar un grupo de administración.

PATCH 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
displayName	string	Nombre descriptivo del grupo de administración.
parentGroupId	string	(Opcional) Identificador completo del grupo de administración primario. Por ejemplo, /providers/Microsoft.Management/managementGroups/00000000-0000-0000-00000-0000000000000

Respuestas

Nombre	Tipo	Description
200 OK	ManagementGroup	Aceptar
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

PatchManagementGroup

Solicitud de ejemplo

HTTP

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


{
  "displayName": "AlternateDisplayName",
  "parentGroupId": "/providers/Microsoft.Management/managementGroups/AlternateRootGroup"
}

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": "AlternateDisplayName",
    "details": {
      "version": 2,
      "updatedTime": "2018-01-25T02:46:59.0545645Z",
      "updatedBy": "bd490e30-04cb-433e-b8c8-6066959a8bab",
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/AlternateRootGroup",
        "name": "AlternateRootGroup",
        "displayName": "AlternateRootGroup"
      }
    }
  }
}

Definiciones

Nombre	Description
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.
PatchManagementGroupRequest	Parámetros de revisión del grupo de administración.

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.

ManagementGroup

Detalles del grupo 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	ManagementGroupChildInfo[]	Lista de elementos secundarios.
properties.details	ManagementGroupDetails	Detalles Detalles de un grupo de administración.
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
type	string	Tipo de recurso. Por ejemplo, Microsoft.Management/managementGroups

ManagementGroupChildInfo

Información secundaria de un grupo de administración.

Nombre	Tipo	Description
children	ManagementGroupChildInfo[]	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)

ManagementGroupChildType

Tipo de recurso secundario.

Nombre	Tipo	Description
/subscriptions	string
Microsoft.Management/managementGroups	string

ManagementGroupDetails

Detalles de un grupo de administración.

Nombre	Tipo	Description
parent	ParentGroupInfo	Parent (Opcional) Identificador del grupo de administración primario.
path	ManagementGroupPathElement[]	Ruta de acceso de la raíz al grupo actual.
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.

ManagementGroupPathElement

Elemento path de los antecesores de un grupo de administración.

Nombre	Tipo	Description
displayName	string	Nombre descriptivo del grupo.
name	string	Nombre del grupo.

ParentGroupInfo

(Opcional) Identificador del grupo de administración primario.

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

PatchManagementGroupRequest

Parámetros de revisión del grupo de administración.

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

Compartir a través de