Groups - Create

Service:

Azure Migrate

API Version:

2019-10-01

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

Nazwa	W	Wymagane	Typ	Opis
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

Nazwa	Wymagane	Typ	Opis
properties	True	GroupProperties	Właściwości grupy.
eTag		string	W przypadku optymistycznej kontroli współbieżności.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Group	OK. Istniejąca grupa została zaktualizowana. Headers x-ms-request-id: string
201 Created	Group	Utworzone. Utworzono nową grupę. Headers x-ms-request-id: string
Other Status Codes	CloudError	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

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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

Definicje

Nazwa	Opis
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.

Nazwa	Typ	Opis
error	CloudErrorBody	Odpowiedź na błąd z usługi Azure Migrate.

CloudErrorBody

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

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
details	CloudErrorBody[]	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.

Nazwa	Typ	Opis
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	GroupProperties	Właściwości grupy.
type	string	Typ obiektu = [Microsoft.Migrate/assessmentProjects/groups].

GroupProperties

Właściwości zasobu grupy.

Nazwa	Typ	Opis
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	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.

Nazwa	Typ	Opis
Completed	string
Created	string
Invalid	string
Running	string
Updated	string