REST API를 사용하여 복제를 구성하는 방법

vSphere Replication REST API를 사용하여 소스 사이트에서 대상 사이트로 가상 시스템 복제를 구성할 수 있습니다.

사전 요구 사항

가상 시스템 복제를 구성하려면 다음을 수행합니다.

VRMS Appliance Management Interface 또는 VRMS 장치 구성 REST API 게이트웨이를 사용하여 vSphere Replication을 PSC(Platform Services Controller)에 등록해야 합니다.
소스 사이트와 대상 사이트 사이에 사이트 쌍이 있어야 합니다.

프로시저

소스 사이트에 로그인하려면 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
```
복제를 구성하려는 VM의 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. 쌍 구성에서 모든 vSphere Replication 관리 서버 인스턴스를 가져오기 위한 GET 요청을 수행합니다.
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vrs
```
  대상 vSphere Replication 관리 서버의 ID를 저장합니다.
3. 대상 vSphere Replication 관리 서버에 등록된 모든 vSphere Replication 서버를 가져오기 위한 GET 요청을 수행합니다.
```
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를 저장합니다.
VM의 디스크에 대한 정보를 가져오려면 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단계에서 가져온 VM의 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
            }
         }
      ]
   }
]