Verwenden der REST APIs zum Konfigurieren einer Replizierung

Sie können die Replizierung virtueller Maschinen von einer Quell-Site auf eine Ziel-Site konfigurieren, indem Sie die vSphere Replication-REST APIs verwenden.

Voraussetzungen

So konfigurieren Sie die Replizierung einer virtuellen Maschine:

Sie müssen Ihre vSphere Replication-Instanz beim Platform Services Controller (PSC) registrieren, indem Sie die VRMS Appliance Management Interface oder das REST API-Gateway für die VRMS-Appliance-Konfiguration verwenden.
Sie müssen über ein Site-Paar zwischen der Quell- und der Ziel-Site verfügen.

Prozedur

Um sich bei der Quell-Site anzumelden, führen Sie eine POST-Anforderung aus.
```
POST BASE_URL/api/rest/vr/API_VERSION/session
```
Geben Sie Ihren Benutzernamen und Ihr Kennwort in den HTTP-Header für die Autorisierung ein. Verwenden Sie die zurückgegebene Sitzungs-ID als Wert für den HTTP-Header x-dr-session für alle nachfolgenden Aufrufe der REST API.

Zum Abrufen der Kopplungs-ID und der lokalen vCenter Server-ID führen Sie eine GET-Anforderung aus.

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

Beispielantwort:

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

Speichern Sie die Kopplungs-ID und die lokale vCenter Server-ID.

Um die IDs der virtuellen Maschinen pro Site-Paar abzurufen, führen Sie eine GET-Anforderung aus.
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vcenters/VC_GUID/vms
```
Speichern Sie die ID der VM, für die Sie die Replizierung konfigurieren möchten.
So rufen Sie die Ziel-vSphere Replication-Server-ID ab:
1. Führen Sie eine POST-Anforderung zur Anmeldung bei der Ziel-Site aus.
```
POST BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/remote-session
```
  Geben Sie Ihren Benutzernamen und Ihr Kennwort in den HTTP-Header für die Autorisierung ein. Stellen Sie sicher, dass der HTTP-Header x-dr-session weiterhin vorhanden ist.
2. Führen Sie eine GET-Anforderung aus, um alle vSphere Replication Management Server-Instanzen bei der Kopplung abzurufen.
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vrs
```
  Speichern Sie die ID des zielseitigen vSphere Replication Management Servers.
3. Führen Sie eine GET-Anforderung aus, um alle vSphere Replication-Server abzurufen, die beim Ziel-vSphere Replication Management Server registriert sind.
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vrs/VR_ID/replication-servers
```
  Ersetzen Sie den PAIRING_ID-Wert durch die ID der Kopplung und den VR_ID-Wert durch die Ziel-vSphere Replication Management Server-ID aus Schritt 4.b.
  
  Speichern Sie die Ziel-vSphere Replication-Server-ID aus dem Ergebnis.
Zum Abrufen des Zieldatenspeichers führen Sie eine GET-Anforderung aus.
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vcenters/VC_ID/datastores
```
Ersetzen Sie den Wert VC_ID durch die ID des zielseitigen vCenter Servers und speichern Sie die Antwort.
Um die ID der bevorzugten Speicherrichtlinie abzurufen, führen Sie eine GET-Anforderung aus.
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vcenters/VC_ID/storage-policies
```
Ersetzen Sie den Wert VC_ID durch die ID des Ziel-vCenter Servers und speichern Sie die ID der bevorzugten Zielspeicherrichtlinie.
Um Informationen zu den Festplatten einer VM abzurufen, führen Sie eine GET-Anforderung aus.
```
GET BASE_URL/api/rest/vr/API_VERSION/pairings/PAIRING_ID/vcenters/VC_ID/vms/VM_ID/disks
```
Ersetzen Sie den VC_ID-Wert durch die ID des Quell-vCenter Servers, ersetzen Sie den VM_ID-Wert durch die ID der VM, die Sie in Schritt 3 erhalten haben, und speichern Sie die Antwort.

Führen Sie zum Konfigurieren der Replizierung eine POST-Anforderung aus.

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

Textbeispiel für die Anforderung der Replizierungskonfiguration:

[
   {
      "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
            }
         }
      ]
   }
]