你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Hyper V Collectors - Create

创建或更新 Hyper-V 收集器

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

URI 参数

Name In Required Type Description
hyperVCollectorName
path True
  • string

项目中 Hyper-V 收集器的唯一名称。

projectName
path True
  • string

Azure Migrate 项目的名称。

resourceGroupName
path True
  • string

项目所属的 Azure 资源组的名称。

subscriptionId
path True
  • string

在其中创建了项目的 Azure 订阅 ID。

api-version
query True
  • string

标准请求标头。 由服务用来标识客户端使用的 API 版本。

请求正文

Name Type Description
eTag
  • string
properties

响应

Name Type Description
200 OK

没问题。 现有的 Hyper-V 收集器。

Headers

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

Created. 创建了新的 Hyper-V 收集器。

Headers

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

描述操作失败的原因的错误响应。

安全性

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 模拟用户帐户

示例

HyperVCollectors_Create

Sample Request

PUT https://management.azure.com/subscriptions/8c3c936a-c09b-4de3-830b-3f5f244d72e9/resourceGroups/contosoithyperv/providers/Microsoft.Migrate/assessmentProjects/migrateprojectce73project/hypervcollectors/migrateprojectce73collector?api-version=2019-10-01

{
  "properties": {
    "discoverySiteId": "/subscriptions/8c3c936a-c09b-4de3-830b-3f5f244d72e9/resourceGroups/ContosoITHyperV/providers/Microsoft.OffAzure/HyperVSites/migrateprojectce73site",
    "agentProperties": {
      "spnDetails": {
        "authority": "https://login.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47",
        "applicationId": "827f1053-44dc-439f-b832-05416dcce12b",
        "audience": "https://72f988bf-86f1-41af-91ab-2d7cd011db47/migrateprojectce73agentauthaadapp",
        "objectId": "be75098e-c0fc-4ac4-98c7-282ebbcf8370",
        "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
      }
    }
  },
  "eTag": "\"00000981-0000-0300-0000-5d74cd5f0000\""
}

Sample Response

{
  "eTag": "\"00000981-0000-0300-0000-5d74cd5f0000\"",
  "id": "/subscriptions/8c3c936a-c09b-4de3-830b-3f5f244d72e9/resourceGroups/contosoithyperv/providers/Microsoft.Migrate/assessmentprojects/migrateprojectce73project/hypervcollectors/migrateprojectce73collector",
  "name": "migrateprojectce73collector",
  "type": "Microsoft.Migrate/assessmentprojects/hypervcollectors",
  "properties": {
    "discoverySiteId": "/subscriptions/8c3c936a-c09b-4de3-830b-3f5f244d72e9/resourceGroups/ContosoITHyperV/providers/Microsoft.OffAzure/HyperVSites/migrateprojectce73site",
    "createdTimestamp": "2019-04-10T10:22:51.6271816Z",
    "updatedTimestamp": "2019-09-08T09:43:59.0573145Z",
    "agentProperties": {
      "id": "d86c7d5a-2103-5157-bb20-9026b75e5de8",
      "version": "1.0.8.218",
      "lastHeartbeatUtc": "2019-09-08T09:43:59.0573145Z",
      "spnDetails": {
        "authority": "https://login.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47",
        "applicationId": "827f1053-44dc-439f-b832-05416dcce12b",
        "audience": "https://72f988bf-86f1-41af-91ab-2d7cd011db47/migrateprojectce73agentauthaadapp",
        "objectId": "be75098e-c0fc-4ac4-98c7-282ebbcf8370",
        "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
      }
    }
  }
}
{
  "eTag": "\"00000981-0000-0300-0000-5d74cd5f0000\"",
  "id": "/subscriptions/8c3c936a-c09b-4de3-830b-3f5f244d72e9/resourceGroups/contosoithyperv/providers/Microsoft.Migrate/assessmentprojects/migrateprojectce73project/hypervcollectors/migrateprojectce73collector",
  "name": "migrateprojectce73collector",
  "type": "Microsoft.Migrate/assessmentprojects/hypervcollectors",
  "properties": {
    "discoverySiteId": "/subscriptions/8c3c936a-c09b-4de3-830b-3f5f244d72e9/resourceGroups/ContosoITHyperV/providers/Microsoft.OffAzure/HyperVSites/migrateprojectce73site",
    "createdTimestamp": "2019-04-10T10:22:51.6271816Z",
    "updatedTimestamp": "2019-09-08T09:43:59.0573145Z",
    "agentProperties": {
      "id": "d86c7d5a-2103-5157-bb20-9026b75e5de8",
      "version": "1.0.8.218",
      "lastHeartbeatUtc": "2019-09-08T09:43:59.0573145Z",
      "spnDetails": {
        "authority": "https://login.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47",
        "applicationId": "827f1053-44dc-439f-b832-05416dcce12b",
        "audience": "https://72f988bf-86f1-41af-91ab-2d7cd011db47/migrateprojectce73agentauthaadapp",
        "objectId": "be75098e-c0fc-4ac4-98c7-282ebbcf8370",
        "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47"
      }
    }
  }
}

定义

CloudError

Azure Migrate 服务的错误响应。

CloudErrorBody

Azure Migrate 服务的错误响应。

CollectorAgentProperties
CollectorBodyAgentSpnProperties
CollectorProperties
HyperVCollector

CloudError

Azure Migrate 服务的错误响应。

Name Type Description
error

Azure Migrate 服务的错误响应。

CloudErrorBody

Azure Migrate 服务的错误响应。

Name Type Description
code
  • string

错误的标识符。 代码是固定的,旨在以编程方式使用。

details

有关错误的其他详细信息的列表。

message
  • string

描述错误的消息,旨在适合在用户界面中显示。

target
  • string

特定错误的目标。 例如,错误属性的名称。

CollectorAgentProperties

Name Type Description
id
  • string
lastHeartbeatUtc
  • string
spnDetails
version
  • string

CollectorBodyAgentSpnProperties

Name Type Description
applicationId
  • string

本地管理/数据平面组件将与 Azure 服务通信的服务主体的应用程序/客户端 ID。

audience
  • string

服务主体的预期受众。

authority
  • string

AAD 颁发机构 URL,用于请求服务主体的令牌。

objectId
  • string

本地管理/数据平面组件将与 Azure 服务通信的服务主体的对象 ID。

tenantId
  • string

本地管理/数据平面组件将与 Azure 服务通信的服务主体的租户 ID。

CollectorProperties

Name Type Description
agentProperties
createdTimestamp
  • string

创建此收集器的时间。 Date-Time以 ISO-8601 格式表示。

discoverySiteId
  • string

发现服务站点的 ARM ID。

updatedTimestamp
  • string

更新此收集器的时间。 Date-Time以 ISO-8601 格式表示。

HyperVCollector

Name Type Description
eTag
  • string
id
  • string
name
  • string
properties
type
  • string