Groups - Create

Service:

Azure Migrate

API Version:

2019-10-01

지정된 설정을 사용하여 새 그룹을 만듭니다.
요청 본문의 일부로 Models 섹션에 지정된 대로 'group' 형식의 json 개체를 전송하여 새 그룹을 만듭니다. 프로젝트의 그룹 이름은 고유합니다.

이 작업은 Idempotent입니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
groupName	path	True	string	프로젝트 내 그룹의 고유 이름입니다.
projectName	path	True	string	Azure Migrate 프로젝트의 이름입니다.
resourceGroupName	path	True	string	프로젝트가 속한 Azure 리소스 그룹의 이름입니다.
subscriptionId	path	True	string	프로젝트를 만든 Azure 구독 ID입니다.
api-version	query	True	string	표준 요청 헤더입니다. 서비스에서 클라이언트에서 사용하는 API 버전을 식별하는 데 사용됩니다.

요청 본문

Name	필수	형식	Description
properties	True	GroupProperties	그룹의 속성입니다.
eTag		string	낙관적 동시성 제어의 경우.

응답

Name	형식	Description
200 OK	Group	OK. 기존 그룹이 업데이트되었습니다. Headers x-ms-request-id: string
201 Created	Group	만들어졌습니다. 새 그룹이 만들어졌습니다. Headers x-ms-request-id: string
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name	Description
user_impersonation	사용자 계정 가장

예제

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

정의

Name	Description
CloudError	Azure Migrate 서비스의 오류 응답입니다.
CloudErrorBody	Azure Migrate 서비스의 오류 응답입니다.
Group	마이그레이션 프로젝트에서 만든 그룹입니다.
GroupProperties	그룹 리소스의 속성입니다.
GroupStatus	그룹이 만들어졌으며 유효한지 여부입니다.

CloudError

Azure Migrate 서비스의 오류 응답입니다.

Name	형식	Description
error	CloudErrorBody	Azure Migrate 서비스의 오류 응답입니다.

CloudErrorBody

Azure Migrate 서비스의 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.
details	CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target	string	특정 오류의 대상입니다. 예를 들어 오류에 있는 속성의 이름입니다.

Group

마이그레이션 프로젝트에서 만든 그룹입니다.

Name	형식	Description
eTag	string	낙관적 동시성 제어의 경우.
id	string	이 그룹에 대한 경로 참조입니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/assessmentProjects/{projectName}/groups/{groupName}
name	string	그룹의 이름입니다.
properties	GroupProperties	그룹의 속성입니다.
type	string	개체의 형식 = [Microsoft.Migrate/assessmentProjects/groups].

GroupProperties

그룹 리소스의 속성입니다.

Name	형식	Description
areAssessmentsRunning	boolean	평가가 실행 중 상태인 경우
assessments	string[]	이 그룹에서 만든 평가에 대한 참조 목록입니다.
createdTimestamp	string	이 그룹을 만든 시간입니다. Date-Time ISO-8601 형식으로 표시됩니다.
groupStatus	GroupStatus	그룹이 만들어졌으며 유효한지 여부입니다.
groupType	string	그룹의 형식입니다.
machineCount	integer	이 그룹의 일부인 컴퓨터 수입니다.
updatedTimestamp	string	이 그룹이 마지막으로 업데이트된 시간입니다. Date-Time ISO-8601 형식으로 표시됩니다.

GroupStatus

그룹이 만들어졌으며 유효한지 여부입니다.

Name	형식	Description
Completed	string
Created	string
Invalid	string
Running	string
Updated	string