如何使用 REST API 配置复制

您可以使用 vSphere Replication REST API 配置从源站点到目标站点的虚拟机复制。

前提条件

要配置虚拟机复制，请执行以下操作：

您必须使用 vSphere Replication 或 VRMS 设备配置 REST API 网关将 VRMS Appliance Management Interface 注册到 Platform Services Controller (PSC)。
您必须在源站点和目标站点之间建立站点对。

过程

要登录到源站点，请发出 POST 请求。
```
POST BASE_URL/api/rest/vr/API_VERSION/session
```
在授权 HTTP 标头中输入您的用户名和密码。使用返回的会话 ID 作为对 REST API 的所有后续调用的 x-dr-session HTTP 标头的值。

要获取配对 ID 和本地 vCenter Server ID，请发出 GET 请求。

GET BASE_URL/api/rest/vr/API_VERSION/pairings/

示例响应：

{
   "pairing_id": "e41c183f-bc55-319b-bf76-8ec83d335074", <----------- Pairing ID
   "local_vc_server": {
      "id": "0a98c22d-a553-47e4-bd56-2844f45d8ef6", <--------------- VC ID
      "url": "https://s2-srm2-219-12.eng.vmware.com:443/sdk",
      "name": "s2-srm2-219-12.eng.vmware.com",
      "server_status": "OK",
      // Other fields are not relevant in this example
}

保存配对 ID 和本地 vCenter Server ID。

要获取每个站点对的虚拟机 ID，请发出 GET 请求。
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vcenters/VC_GUID/vms
```
保存要配置复制的虚拟机的 ID。
要获取目标 vSphere Replication 服务器 ID，请执行以下操作：
1. 发出 POST 请求以登录到目标站点。
```
POST BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/remote-session
```
  在授权 HTTP 标头中输入您的用户名和密码。确保 x-dr-session HTTP 标头仍然存在。
2. 发出 GET 请求以获取配对的所有 vSphere Replication 管理服务器实例。
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vrs
```
  保存目标 vSphere Replication 管理服务器的 ID。
3. 发出 GET 请求以获取注册到目标 vSphere Replication 管理服务器的所有 vSphere Replication 服务器。
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vrs/VR_ID/replication-servers
```
  将 PAIRING_ID 值替换为配对的 ID，将 VR_ID 值替换为步骤 4.b 中的目标 vSphere Replication 管理服务器 ID。
  
  保存结果中的目标 vSphere Replication 服务器 ID。
要获取目标数据存储，请发出 GET 请求。
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vcenters/VC_ID/datastores
```
将 VC_ID 值替换为目标 vCenter Server 的 ID，然后保存响应。
要获取首选存储策略 ID，请发出 GET 请求。
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vcenters/VC_ID/storage-policies
```
将 VC_ID 值替换为目标 vCenter Server 的 ID，并保存首选目标存储策略 ID。
要获取有关虚拟机磁盘的信息，请发出 GET 请求。
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vcenters/VC_ID/vms/VM_ID/disks
```
将 VC_ID 值替换为源 vCenter Server 的 ID，将 VM_ID 值替换为您在步骤 3 中获取的虚拟机的 ID，然后保存响应。

要配置复制，请发出 POST 请求。

POST BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/replications

示例配置复制请求正文：

[
   {
      "auto_replicate_new_disks": true,
      "rpo": 60,
      "lwd_encryption_enabled": false,
      "mpit_days": 0,
      "mpit_enabled": false,
      "mpit_instances": 0,
      "network_compression_enabled": false,
      "quiesce_enabled": false,
      // You get this from Step 3.
      "vm_id": "VirtualMachine:vm-38:fa655d23-b8ac-4eb1-8351-129954807e2c",
      //You get this from Step 4.
      "target_replication_server_id": "HmsRemoteHbrServer:HBRSRV-26c6bd13-1fac-4d04-adcb-2700a258025c:b41aa649-bd9b-45e0-9d41-a7a16c0b0946",
      "target_vc_id": "54d0e5ab-3e9d-4372-9f27-036cf1c24639"
      "disks": [
         {
            //  You get this from Step 5.
            "destination_datastore_id": "Datastore:datastore-18:54d0e5ab-3e9d-4372-9f27-036cf1c24639",
            // Options for destination_disk_format parameter: SAME_AS_SOURCE, SAME_AS_PRIMARY, AS_DEFINED_IN_PROFILE, FLAT, THICK, NATIVE_THICK, THIN, RDM.
            "destination_disk_format": "SAME_AS_SOURCE",
            "enabled_for_replication": true,
            "use_seeds": false,
            "destination_path": "target_folder/test-vm-1",
            // You get this from Step 6.
            "destination_storage_policy_id": "4b97756b-3c50-481a-a105-d6a7b1507f9a",
           //  You got this from Step 7.
            "vm_disk" : {
                "vm_id": "VirtualMachine:vm-38:fa655d23-b8ac-4eb1-8351-129954807e2c",
                "device_key": 2000,
                "is_vm_home": false,
                "encrypted": false,
                "capacity": 524288,
                "source_disk_format": "THIN",
                "source_path": {
                    "datastore_id": "Datastore:datastore-17:fa655d23-b8ac-4eb1-8351-129954807e2c",
                    "datastore_name": "local",
                    "path": "test-vm-1",
                    "filename": "test-vm-1.vmdk"
                },
                "source_storage_policy_name": "Datastore Default",
                "source_storage_policy_id": null,
                "label": "Hard disk 1",
                "controller_key": 1000,
                "controller_label": "SCSI controller 0",
                "supported_for_replication": true
            }
         },
         {
            //  You get this from Step 5.
            "destination_datastore_id": "Datastore:datastore-18:54d0e5ab-3e9d-4372-9f27-036cf1c24639",
            "destination_disk_format": "SAME_AS_SOURCE",
            "enabled_for_replication": true,
            "use_seeds": false,
            "destination_path": "target_folder/test-vm-1",
            //  You get this from Step 6.
            "destination_storage_policy_id": "4b97756b-3c50-481a-a105-d6a7b1507f9a",
            // You get this from Step 7.
            "vm_disk" : {
                "vm_id": "VirtualMachine:vm-38:fa655d23-b8ac-4eb1-8351-129954807e2c",
                "device_key": 0,
                "is_vm_home": true,
                "encrypted": false,
                "capacity": 0,
                "source_disk_format": null,
                "source_path": {
                    "datastore_id": "Datastore:datastore-17:fa655d23-b8ac-4eb1-8351-129954807e2c",
                    "datastore_name": "local",
                    "path": "test-vm-1",
                    "filename": "test-vm-1.vmx"
                },
                "source_storage_policy_name": "Datastore Default",
                "source_storage_policy_id": null,
                "label": "VM home",
                "controller_key": 0,
                "controller_label": null,
                "supported_for_replication": false
            }
         }
      ]
   }
]