Groups - Create

リファレンス

Service:: Azure Migrate

API Version:: 2019-10-01

指定した設定で新しいグループを作成します。
要求本文の一部として Models セクションに示されているように、型 'group' の json オブジェクトを送信して、新しいグループを作成します。プロジェクト内のグループ名は一意です。

この操作はべき等です。

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

URI パラメーター

名前	/	必須	型	説明
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 バージョンを識別するためにサービスによって使用されます。

要求本文

名前	必須	型	説明
properties	True	GroupProperties	グループのプロパティ。
eTag		string	オプティミスティックコンカレンシー制御の場合。

応答

名前	型	説明
200 OK	Group	OK です。既存のグループが更新されました。 Headers x-ms-request-id: string
201 Created	Group	作成されました。新しいグループが作成されました。 Headers x-ms-request-id: string
Other Status Codes	CloudError	操作に失敗した理由を説明するエラー応答。

名前

型

説明

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 フロー

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

Scopes

名前	説明
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"
  }
}

定義

名前	説明
CloudError	Azure Migrate サービスからのエラー応答。
CloudErrorBody	Azure Migrate サービスからのエラー応答。
Group	移行プロジェクトで作成されたグループ。
GroupProperties	グループリソースのプロパティ。
GroupStatus	グループが作成され、有効かどうか。

CloudError

Azure Migrate サービスからのエラー応答。

名前	型	説明
error	CloudErrorBody	Azure Migrate サービスからのエラー応答。

CloudErrorBody

Azure Migrate サービスからのエラー応答。

名前	型	説明
code	string	エラーの識別子。コードは不変であり、プログラムによって使用されることを意図しています。
details	CloudErrorBody[]	エラーに関するその他の詳細の一覧。
message	string	ユーザーインターフェイスでの表示に適したエラーを説明するメッセージ。
target	string	特定のエラーのターゲット。たとえば、エラーが発生したプロパティの名前です。

Group

移行プロジェクトで作成されたグループ。

名前	型	説明
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

グループリソースのプロパティ。

名前	型	説明
areAssessmentsRunning	boolean	評価が実行中の状態の場合。
assessments	string[]	このグループで作成された評価への参照の一覧。
createdTimestamp	string	このグループが作成された時刻。 Date-Time ISO-8601 形式で表されます。
groupStatus	GroupStatus	グループが作成され、有効かどうか。
groupType	string	グループの種類。
machineCount	integer	このグループに含まれるマシンの数。
updatedTimestamp	string	このグループが最後に更新された時刻。 Date-Time ISO-8601 形式で表されます。

GroupStatus

グループが作成され、有効かどうか。

名前	型	説明
Completed	string
Created	string
Invalid	string
Running	string
Updated	string

Groups - Create

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

Scopes

例

Groups_Create

Sample Request

Sample Response

定義

CloudError

CloudErrorBody

Group

GroupProperties

GroupStatus

その他のリソース