Groups - Create

Crie um novo grupo com as configurações especificadas.
Crie um novo grupo enviando um objeto json do tipo 'group' conforme fornecido na seção Modelos como parte do Corpo da Solicitação. O nome do grupo em um projeto é exclusivo.

Esta operação é 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 URI

Name In Required Type Description
groupName
path True
  • string

Nome exclusivo de um grupo dentro de um projeto.

projectName
path True
  • string

Nome do projeto de Migrações para Azure.

resourceGroupName
path True
  • string

Nome do Grupo de Recursos do Azure do qual o projeto faz parte.

subscriptionId
path True
  • string

ID de Assinatura do Azure na qual o projeto foi criado.

api-version
query True
  • string

Cabeçalho de solicitação padrão. Usado pelo serviço para identificar a versão da API usada pelo cliente.

Corpo da solicitação

Name Required Type Description
properties True

Propriedades do grupo.

eTag
  • string

Para controle de simultaneidade otimista.

Respostas

Name Type Description
200 OK

OK. Grupo existente atualizado.

Headers

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

Criado. Novo grupo foi criado.

Headers

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

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

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

Definições

CloudError

Uma resposta de erro do serviço de Migrações para Azure.

CloudErrorBody

Uma resposta de erro do serviço de Migrações para Azure.

Group

Um grupo criado em um projeto de Migração.

GroupProperties

Propriedades do recurso de grupo.

GroupStatus

Se o grupo foi criado e é válido.

CloudError

Uma resposta de erro do serviço de Migrações para Azure.

Name Type Description
error

Uma resposta de erro do serviço de Migrações para Azure.

CloudErrorBody

Uma resposta de erro do serviço de Migrações para Azure.

Name Type Description
code
  • string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

details

Uma lista de detalhes adicionais sobre o erro.

message
  • string

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

target
  • string

O destino do erro específico. Por exemplo, o nome da propriedade em erro.

Group

Um grupo criado em um projeto de Migração.

Name Type Description
eTag
  • string

Para controle de simultaneidade otimista.

id
  • string

Referência de caminho para esse grupo. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}

name
  • string

Nome do grupo.

properties

Propriedades do grupo.

type
  • string

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

GroupProperties

Propriedades do recurso de grupo.

Name Type Description
areAssessmentsRunning
  • boolean

Se as avaliações estiverem em estado de execução.

assessments
  • string[]

Lista de referências às avaliações criadas nesse grupo.

createdTimestamp
  • string

Hora em que esse grupo foi criado. Date-Time representado no formato ISO-8601.

groupStatus

Se o grupo foi criado e é válido.

groupType
  • string

O tipo de grupo.

machineCount
  • integer

Número de computadores que fazem parte desse grupo.

updatedTimestamp
  • string

Hora em que esse grupo foi atualizado pela última vez. Date-Time representado no formato ISO-8601.

GroupStatus

Se o grupo foi criado e é válido.

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