Groups - Create

Utwórz nową grupę z określonymi ustawieniami.
Utwórz nową grupę, wysyłając obiekt JSON typu "group" zgodnie z opisem w sekcji Modele w ramach treści żądania. Nazwa grupy w projekcie jest unikatowa.

Ta operacja jest idempotentna.

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

Parametry identyfikatora URI

Name In Required Type Description
groupName
path True
  • string

Unikatowa nazwa grupy w projekcie.

projectName
path True
  • string

Nazwa projektu usługi Azure Migrate.

resourceGroupName
path True
  • string

Nazwa grupy zasobów platformy Azure, do którego należy projekt.

subscriptionId
path True
  • string

Identyfikator subskrypcji platformy Azure, w którym został utworzony projekt.

api-version
query True
  • string

Nagłówek żądania standardowego. Używany przez usługę do identyfikowania wersji interfejsu API używanej przez klienta.

Treść żądania

Name Required Type Description
properties True

Właściwości grupy.

eTag
  • string

W przypadku optymistycznej kontroli współbieżności.

Odpowiedzi

Name Type Description
200 OK

OK. Istniejąca grupa została zaktualizowana.

Headers

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

Utworzone. Utworzono nową grupę.

Headers

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

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

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

Definicje

CloudError

Odpowiedź na błąd z usługi Azure Migrate.

CloudErrorBody

Odpowiedź na błąd z usługi Azure Migrate.

Group

Grupa utworzona w projekcie migracji.

GroupProperties

Właściwości zasobu grupy.

GroupStatus

Czy grupa została utworzona i jest prawidłowa.

CloudError

Odpowiedź na błąd z usługi Azure Migrate.

Name Type Description
error

Odpowiedź na błąd z usługi Azure Migrate.

CloudErrorBody

Odpowiedź na błąd z usługi Azure Migrate.

Name Type Description
code
  • string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

details

Lista dodatkowych szczegółów dotyczących błędu.

message
  • string

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

target
  • string

Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie.

Group

Grupa utworzona w projekcie migracji.

Name Type Description
eTag
  • string

W przypadku optymistycznej kontroli współbieżności.

id
  • string

Odwołanie do ścieżki do tej grupy. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}

name
  • string

Nazwa grupy.

properties

Właściwości grupy.

type
  • string

Typ obiektu = [Microsoft.Migrate/assessmentProjects/groups].

GroupProperties

Właściwości zasobu grupy.

Name Type Description
areAssessmentsRunning
  • boolean

Jeśli oceny są w stanie uruchomienia.

assessments
  • string[]

Lista odwołań do ocen utworzonych w tej grupie.

createdTimestamp
  • string

Godzina utworzenia tej grupy. Date-Time reprezentowane w formacie ISO-8601.

groupStatus

Czy grupa została utworzona i jest prawidłowa.

groupType
  • string

Typ grupy.

machineCount
  • integer

Liczba maszyn należących do tej grupy.

updatedTimestamp
  • string

Czas ostatniej aktualizacji tej grupy. Date-Time reprezentowane w formacie ISO-8601.

GroupStatus

Czy grupa została utworzona i jest prawidłowa.

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