Groups - Create

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

Name In Required Type 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

Name Required Type Description
properties True

Propiedades del grupo.

eTag
  • string

Para el control de simultaneidad optimista.

Respuestas

Name Type Description
200 OK

Aceptar. Grupo existente actualizado.

Headers

  • x-ms-request-id: string
201 Created

Creado. Se creó un nuevo grupo.

Headers

  • x-ms-request-id: string
Other Status Codes

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

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

Scopes

Name Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Groups_Create

Sample Request

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

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

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.

Name Type Description
error

Respuesta de error del servicio Azure Migrate.

CloudErrorBody

Respuesta de error del servicio Azure Migrate.

Name Type Description
code
  • string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

details

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.

Name Type 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

Propiedades del grupo.

type
  • string

Tipo del objeto = [Microsoft.Migrate/assessmentProjects/groups].

GroupProperties

Propiedades del recurso de grupo.

Name Type 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

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.

Name Type Description
Completed
  • string
Created
  • string
Invalid
  • string
Running
  • string
Updated
  • string