Groups - Update Machines

Servicio:

Azure Migrate

Versión de la API:

2019-10-01

Actualice las máquinas en grupo agregando o quitando máquinas.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}/updateMachines?api-version=2019-10-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
groupName	path	True	string	Nombre único de un grupo dentro de un proyecto.
projectName	path	True	string	Nombre del proyecto de Azure Migrate.
resourceGroupName	path	True	string	Nombre del grupo de recursos de Azure del que forma parte el proyecto.
subscriptionId	path	True	string	Identificador de suscripción de Azure en el que se creó el proyecto.
api-version	query	True	string	Encabezado de solicitud estándar. Usado por el servicio para identificar la versión de API usada por el cliente.

Cuerpo de la solicitud

Nombre	Tipo	Description
eTag	string	Para el control de simultaneidad optimista.
properties	GroupBodyProperties	Propiedades del grupo.

Respuestas

Nombre	Tipo	Description
200 OK	Group	De acuerdo. Grupo existente actualizado. Encabezados x-ms-request-id: string
Other Status Codes	CloudError	Respuesta de error que describe por qué se produjo un error en la operación.

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	suplantar la cuenta de usuario

Ejemplos

Groups_UpdateMachines

Solicitud de ejemplo

HTTP

POST https://management.azure.com/subscriptions/6393a73f-8d55-47ef-b6dd-179b3e0c7910/resourceGroups/abgoyal-westEurope/providers/Microsoft.Migrate/assessmentProjects/abgoyalWEselfhostb72bproject/groups/Group2/updateMachines?api-version=2019-10-01

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/6393a73f-8d55-47ef-b6dd-179b3e0c7910/resourceGroups/abgoyal-westeurope/providers/Microsoft.Migrate/assessmentprojects/abgoyalWEselfhostb72bproject/groups/Test1",
  "name": "Group2",
  "eTag": "\"1e000c2c-0000-0d00-0000-5cdaa4190000\"",
  "type": "Microsoft.Migrate/assessmentprojects/groups",
  "properties": {
    "groupStatus": "Completed",
    "machineCount": 26,
    "assessments": [
      "/subscriptions/6393a73f-8d55-47ef-b6dd-179b3e0c7910/resourceGroups/abgoyal-westeurope/providers/Microsoft.Migrate/assessmentprojects/abgoyalWEselfhostb72bproject/groups/Test1/assessments/assessment_5_9_2019_16_22_14"
    ],
    "areAssessmentsRunning": false,
    "createdTimestamp": "2019-05-09T10:52:07.7368474Z",
    "updatedTimestamp": "2019-05-10T14:07:41.752989Z"
  }
}

Definiciones

Nombre	Description
CloudError	Respuesta de error del servicio Azure Migrate.
CloudErrorBody	Respuesta de error del servicio Azure Migrate.
Group	Un grupo creado en un proyecto de migración.
GroupBodyProperties	Propiedades del cuerpo de la actualización de grupo.
GroupProperties	Propiedades del recurso de grupo.
GroupStatus	Si el grupo se ha creado y es válido.
GroupUpdateOperation	Si se van a agregar o quitar las máquinas.
UpdateGroupBody	Propiedades de la actualización de grupo.

CloudError

Object

Respuesta de error del servicio Azure Migrate.

Nombre	Tipo	Description
error	CloudErrorBody	Respuesta de error del servicio Azure Migrate.

CloudErrorBody

Object

Respuesta de error del servicio Azure Migrate.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details	CloudErrorBody[]	Lista de detalles adicionales sobre el error.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

Group

Object

Un grupo creado en un proyecto de migración.

Nombre	Tipo	Description
eTag	string	Para el control de simultaneidad optimista.
id	string	Referencia de ruta de acceso a este grupo. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}
name	string	Nombre del grupo.
properties	GroupProperties	Propiedades del grupo.
type	string	Tipo del objeto = [Microsoft.Migrate/assessmentProjects/groups].

GroupBodyProperties

Object

Propiedades del cuerpo de la actualización de grupo.

Nombre	Tipo	Description
machines	string[]	Lista de nombres de máquina que forman parte de este grupo.
operationType	GroupUpdateOperation	Si se van a agregar o quitar las máquinas.

GroupProperties

Object

Propiedades del recurso de grupo.

Nombre	Tipo	Description
areAssessmentsRunning	boolean	Si las evaluaciones están en estado de ejecución.
assessments	string[]	Lista de referencias a evaluaciones creadas en este grupo.
createdTimestamp	string (date-time)	Hora en que se creó este grupo. Date-Time representado en formato ISO-8601.
groupStatus	GroupStatus	Si el grupo se ha creado y es válido.
groupType	string	Tipo de grupo.
machineCount	integer (int32)	Número de máquinas que forman parte de este grupo.
updatedTimestamp	string (date-time)	Hora en que se actualizó por última vez este grupo. Date-Time representado en formato ISO-8601.

GroupStatus

Enumeración

Si el grupo se ha creado y es válido.

Valor	Description
Completed
Created
Invalid
Running
Updated

GroupUpdateOperation

Enumeración

Si se van a agregar o quitar las máquinas.

Valor	Description
Add
Remove

UpdateGroupBody

Object

Propiedades de la actualización de grupo.

Nombre	Tipo	Description
eTag	string	Para el control de simultaneidad optimista.
properties	GroupBodyProperties	Propiedades del grupo.