Groups - Create

Service:

Azure Migrate

API Version:

2019-10-01

Cree un nuevo grupo con la configuración especificada.
Cree un grupo mediante el envío de un objeto JSON de tipo "group" tal y como se indica en la sección Modelos como parte del cuerpo de la solicitud. El nombre del grupo de un proyecto es único.

Esta operación es idempotente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}?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. Lo usa el servicio para identificar la versión de API usada por el cliente.

Cuerpo de la solicitud

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

Respuestas

Nombre	Tipo	Description
200 OK	Group	Aceptar. Grupo existente actualizado. Headers x-ms-request-id: string
201 Created	Group	Creado. Se creó un nuevo grupo. Headers x-ms-request-id: string
Other Status Codes	CloudError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Groups_Create

Sample Request

HTTP

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

{
  "properties": {},
  "eTag": "\"1e000c2c-0000-0d00-0000-5cdaa4190000\""
}

Sample Response

Status code:

201

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

Status code:

200

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

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.
GroupProperties	Propiedades del recurso de grupo.
GroupStatus	Si el grupo se ha creado y es válido.

CloudError

Respuesta de error del servicio Azure Migrate.

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

CloudErrorBody

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

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].

GroupProperties

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	Hora a la 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	Número de máquinas que forman parte de este grupo.
updatedTimestamp	string	Hora a la que se actualizó por última vez este grupo. Date-Time representado en formato ISO-8601.

GroupStatus

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

Nombre	Tipo	Description
Completed	string
Created	string
Invalid	string
Running	string
Updated	string