Update API documentation

Signed-off-by: Mihaela Balutoiu <mbalutoiu@cloudbasesolutions.com>
cloudbase · Sep 9, 2024 · 1d0f658 · 1d0f658
1 parent 24c52ea
commit 1d0f658
Show file tree

Hide file tree

Showing 31 changed files with 168 additions and 42 deletions.
diff --git a/coriolis/api-refs/api_samples/diagnostics/diagnostics-get-resp.json b/coriolis/api-refs/api_samples/diagnostics/diagnostics-get-resp.json
@@ -59,7 +59,35 @@
                         ]
                     }
                 }
-            ]
+            ],
+            "licensing_status": {
+                "appliance_id": "123e4567-e89b-12d3-a456-426614176000",
+                "earliest_licence_expiry_time": "2024-09-07T13:09:21Z",
+                "latest_licence_expiry_time": "2024-09-07T13:09:21Z",
+                "current_performed_migrations": 0,
+                "current_performed_replicas": 0,
+                "lifetime_performed_migrations": 2,
+                "lifetime_performed_replicas": 1,
+                "current_available_migrations": 10,
+                "current_available_replicas": 10,
+                "lifetime_available_migrations": 10,
+                "lifetime_available_replicas": 10
+            },
+            "licences": [
+                {
+                    "id": "e7b8a9f0-4d3b-4a6a-8c1d-2f8e4d9a9b1f",
+                    "appliance_id": "123e4567-e89b-12d3-a456-476614174000",
+                    "issue_date": "2024-09-03T09:53:44Z",
+                    "licence_version": "v2",
+                    "migrations": 10,
+                    "replicas": 10,
+                    "period_start": "2024-09-03T09:54:21Z",
+                    "period_duration": 20,
+                    "period_end": "2024-09-07T13:09:21Z",
+                    "application_date": "2024-09-03T09:53:56Z"
+                }
+            ],
+            "reservations": []
         },
         {
             "application": "coriolis-replica-cron",

diff --git a/coriolis/api-refs/api_samples/endpoint/endpoint-instance-list-resp.json b/coriolis/api-refs/api_samples/endpoint/endpoint-instance-list-resp.json
@@ -9,7 +9,8 @@
       "id": "3ba07383-6726-4bf8-82d5-d5ce871519bc",
       "flavor_name": "m1.small",
       "os_type": "linux",
-      "firmware_type": "BIOS"
+      "firmware_type": "BIOS",
+      "secure_boot": false
     },
     {
       "num_cpu": 4,
@@ -20,7 +21,8 @@
       "id": "e93f6d38-9240-4dec-b738-61ca225aba6a",
       "flavor_name": "windows2012",
       "os_type": "windows",
-      "firmware_type": "EFI"
+      "firmware_type": "EFI",
+      "secure_boot": false
     }
   ]
 }
diff --git a/coriolis/api-refs/api_samples/endpoint/endpoint-instance-show-resp.json b/coriolis/api-refs/api_samples/endpoint/endpoint-instance-show-resp.json
@@ -36,6 +36,7 @@
       "controllers": []
     },
     "os_type": "linux",
-    "firmware_type": "BIOS"
+    "firmware_type": "BIOS",
+    "secure_boot": false
   }
 }
diff --git a/coriolis/api-refs/api_samples/endpoint/endpoint-network-list-resp.json b/coriolis/api-refs/api_samples/endpoint/endpoint-network-list-resp.json
@@ -2,11 +2,13 @@
   "networks": [
     {
       "id": "2734b848-1e4a-4e94-b566-71060d913f80",
-      "name": "shared"
+      "name": "shared",
+      "port_security_enabled": true
     },
     {
       "id": "a57e180a-5626-459e-b59b-bd5491ebef6d",
-      "name": "public"
+      "name": "public",
+      "port_security_enabled": true
     }
   ]
 }
diff --git a/...pi-refs/api_samples/endpoint/openstack-endpoint-source-minion-pool-options-list-resp.json b/...pi-refs/api_samples/endpoint/openstack-endpoint-source-minion-pool-options-list-resp.json
@@ -46,6 +46,18 @@
             ],
             "config_default": "m1.small"
         },
+        {
+            "name": "migr_worker_availability_zone",
+            "values": [
+                {
+                    "name": "internal"
+                },
+                {
+                    "id": "nova"
+                }
+            ],
+            "config_default": null
+        },
         {
             "name": "migr_worker_volume_type",
             "values": [

diff --git a/coriolis/api-refs/api_samples/endpoint/openstack-endpoint-source-options-list-resp.json b/coriolis/api-refs/api_samples/endpoint/openstack-endpoint-source-options-list-resp.json
@@ -5,11 +5,13 @@
             "values": [
                 {
                     "name": "ws2008",
-                    "id": "5051a788-f133-4a84-af64-fd35e4c36f24"
+                    "id": "5051a788-f133-4a84-af64-fd35e4c36f24",
+                    "os_type": "windows"
                 },
                 {
                     "name": "debian8",
-                    "id": "f298bc1b-a631-47cc-beef-ffd13e572226"
+                    "id": "f298bc1b-a631-47cc-beef-ffd13e572226",
+                    "os_type": "linux"
                 }
             ],
             "config_default": null

diff --git a/coriolis/api-refs/api_samples/migration/openstack-migration-create-req.json b/coriolis/api-refs/api_samples/migration/openstack-migration-create-req.json
@@ -7,6 +7,7 @@
     "instances": ["ubuntu-xenial", "windows2012r2"],
     "storage_mappings": {},
     "destination_environment": {
+      "migr_flavor_name": "m1.small",
       "storage_mappings": {
         "lvmdriver-1": "lvm-1"
       },

diff --git a/coriolis/api-refs/api_samples/migration/openstack-migration-create-resp.json b/coriolis/api-refs/api_samples/migration/openstack-migration-create-resp.json
@@ -8,6 +8,7 @@
     "user_id": "7cf9b4745d514517b3eae440438136bc",
     "project_id": "ffc16db2011e41f28152897c279b6bcc",
     "destination_environment": {
+        "migr_flavor_name": "m1.small",
         "storage_mappings": {
           "lvmdriver-1": "lvm-1"
         },
@@ -19,7 +20,10 @@
         },
         "migr_network": "provider-net",
         "port_reuse_policy": "keep_mac",
-        "set_dhcp": true
+        "set_dhcp": true,
+        "network_map": {
+          "private": "provider-net"
+        }
     },
     "type": "migration",
     "instances": ["ubuntu-xenial", "windows2012r2"],
@@ -28,7 +32,9 @@
     "origin_endpoint_id": "b59051a2-bbf3-4fb7-a1eb-539db55339dc",
     "destination_endpoint_id": "6258fa20-5d1f-44fa-ae12-c94122263fa3",
     "transfer_result": null,
-    "network_map": {},
+    "network_map": {
+      "private": "provider-net"
+    },
     "storage_mappings": {},
     "source_environment": {},
     "id": "1e31443d-5eb1-403f-9f15-c67a2c372bc3",

diff --git a/coriolis/api-refs/api_samples/migration/openstack-migration-from-replica-resp.json b/coriolis/api-refs/api_samples/migration/openstack-migration-from-replica-resp.json
@@ -8,6 +8,7 @@
     "user_id": "7cf9b4745d514517b3eae440438136bc",
     "project_id": "ffc16db2011e41f28152897c279b6bcc",
     "destination_environment": {
+      "migr_flavor_name": "m1.small",
       "storage_mappings": {
         "lvmdriver-1": "lvm-1"
       },

diff --git a/coriolis/api-refs/api_samples/migration/openstack-migration-get-resp.json b/coriolis/api-refs/api_samples/migration/openstack-migration-get-resp.json
@@ -8,6 +8,7 @@
     "user_id": "7cf9b4745d514517b3eae440438136bc",
     "project_id": "ffc16db2011e41f28152897c279b6bcc",
     "destination_environment": {
+        "migr_flavor_name": "m1.small",
         "storage_mappings": {
           "lvmdriver-1": "lvm-1"
         },
@@ -19,7 +20,10 @@
         },
         "migr_network": "provider-net",
         "port_reuse_policy": "keep_mac",
-        "set_dhcp": true
+        "set_dhcp": true,
+        "network_map": {
+          "private": "provider-net"
+      }
     },
     "type": "migration",
     "instances": ["windows"],
@@ -28,7 +32,9 @@
     "origin_endpoint_id": "b59051a2-bbf3-4fb7-a1eb-539db55339dc",
     "destination_endpoint_id": "6258fa20-5d1f-44fa-ae12-c94122263fa3",
     "transfer_result": null,
-    "network_map": {},
+    "network_map": {
+      "private": "provider-net"
+    },
     "storage_mappings": {},
     "source_environment": {},
     "id": "1e31443d-5eb1-403f-9f15-c67a2c372bc3",

diff --git a/coriolis/api-refs/api_samples/migration/openstack-migration-list-detail-resp.json b/coriolis/api-refs/api_samples/migration/openstack-migration-list-detail-resp.json
@@ -9,6 +9,7 @@
       "user_id": "7cf9b4745d514517b3eae440438136bc",
       "project_id": "ffc16db2011e41f28152897c279b6bcc",
       "destination_environment": {
+        "migr_flavor_name": "m1.small",
         "network_map": {
           "VM Network": "0e83bf34-9cc7-4580-9189-a9d9c3c7abb8"
         },
@@ -25,7 +26,16 @@
               "destination": "lvmdriver-1"
             }
           ]
-        }
+        },
+        "keypair_name": "new-key",
+        "delete_disks_on_vm_termination": false,
+        "migr_image_map": {
+          "linux": "ubuntu-xenial-img",
+          "windows": "63d8f1a4-3192-4edc-b113-0d099b4bc458"
+        },
+        "migr_network": "provider-net",
+        "port_reuse_policy": "keep_mac",
+        "set_dhcp": true
       },
       "type": "migration",
       "instances": [

diff --git a/coriolis/api-refs/api_samples/minion_pool/minion-pool-list-resp.json b/coriolis/api-refs/api_samples/minion_pool/minion-pool-list-resp.json
@@ -6,6 +6,7 @@
             "notes": "",
             "endpoint_id": "8e9b6b0b-ef3b-4127-ac32-a18a30e67749",
             "environment_options": {
+                "data_transfer_mechanism": "HTTPS",
                 "list_all_destination_networks": false,
                 "migr_worker_use_config_drive": false,
                 "migr_image": "bionic",

diff --git a/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-allocate-resp.json b/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-allocate-resp.json
@@ -14,6 +14,7 @@
         "os_type": "linux",
         "platform": "source",
         "environment_options": {
+            "data_transfer_mechanism": "HTTPS",
             "list_all_destination_networks": false,
             "migr_worker_use_config_drive": false,
             "migr_image": "bionic",

diff --git a/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-create-resp.json b/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-create-resp.json
@@ -14,6 +14,7 @@
         "os_type": "linux",
         "platform": "source",
         "environment_options": {
+            "data_transfer_mechanism": "HTTPS",
             "list_all_destination_networks": false,
             "migr_worker_use_config_drive": false,
             "migr_image": "bionic",

diff --git a/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-deallocate-resp.json b/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-deallocate-resp.json
@@ -14,6 +14,7 @@
         "os_type": "linux",
         "platform": "source",
         "environment_options": {
+            "data_transfer_mechanism": "HTTPS",
             "list_all_destination_networks": false,
             "migr_worker_use_config_drive": false,
             "migr_image": "bionic",

diff --git a/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-refresh-resp.json b/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-refresh-resp.json
@@ -14,6 +14,7 @@
         "os_type": "linux",
         "platform": "source",
         "environment_options": {
+            "data_transfer_mechanism": "HTTPS",
             "list_all_destination_networks": false,
             "migr_worker_use_config_drive": false,
             "migr_image": "bionic",

diff --git a/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-show.json b/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-show.json
@@ -14,6 +14,7 @@
         "os_type": "linux",
         "platform": "source",
         "environment_options": {
+            "data_transfer_mechanism": "HTTPS",
             "list_all_destination_networks": false,
             "migr_worker_use_config_drive": false,
             "migr_image": "bionic",

diff --git a/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-update-resp.json b/coriolis/api-refs/api_samples/minion_pool/openstack-minion-pool-update-resp.json
@@ -22,7 +22,7 @@
             "migr_worker_use_fip": true,
             "migr_worker_boot_from_volume": false,
             "migr_fip_pool_name": "b2f0b98e-03a1-4f13-92aa-ece55f34ebf8/038a72ea-1413-493b-82da-4c75a9077fbf",
-            "data_transfer_mechanism": "SSH"
+            "data_transfer_mechanism": "HTTPS"
         },
         "status": "DEALLOCATED",
         "shared_resources": null,

diff --git a/coriolis/api-refs/api_samples/replica/openstack-replica-create-resp.json b/coriolis/api-refs/api_samples/replica/openstack-replica-create-resp.json
@@ -8,6 +8,7 @@
     "user_id": "7cf9b4745d514517b3eae440438136bc",
     "project_id": "ffc16db2011e41f28152897c279b6bcc",
     "destination_environment": {
+      "migr_flavor_name": "m1.small",
       "network_map": {
         "private": "provider-net"
       },

diff --git a/coriolis/api-refs/api_samples/replica/openstack-replica-get-resp.json b/coriolis/api-refs/api_samples/replica/openstack-replica-get-resp.json
@@ -8,6 +8,7 @@
     "user_id": "7cf9b4745d514517b3eae440438136bc",
     "project_id": "ffc16db2011e41f28152897c279b6bcc",
     "destination_environment": {
+      "migr_flavor_name": "m1.small",
       "network_map": {
         "private": "provider-net"
       },

diff --git a/coriolis/api-refs/api_samples/replica/replica-list-resp.json b/coriolis/api-refs/api_samples/replica/replica-list-resp.json
@@ -9,6 +9,7 @@
       "user_id": "7cf9b4745d514517b3eae440438136bc",
       "project_id": "ffc16db2011e41f28152897c279b6bcc",
       "destination_environment": {
+        "migr_flavor_name": "m1.small",
         "network_map": {
           "VM Network": "0a6b9c01-9ff8-4afa-afba-fa2058fe6cd2"
         },
@@ -25,7 +26,16 @@
               "destination": "lvmdriver-1"
             }
           ]
-        }
+        },
+        "keypair_name": "new-key",
+        "delete_disks_on_vm_termination": false,
+        "migr_image_map": {
+          "linux": "ubuntu-xenial-img",
+          "windows": "63d8f1a4-3192-4edc-b113-0d099b4bc458"
+        },
+        "migr_network": "VM Network",
+        "port_reuse_policy": "keep_mac",
+        "set_dhcp": true
       },
       "type": "replica",
       "instances": [

diff --git a/coriolis/api-refs/api_samples/replica/replica-update-resp.json b/coriolis/api-refs/api_samples/replica/replica-update-resp.json
@@ -8,6 +8,7 @@
     "action_id": "0460aa4d-6b16-4c98-bd56-27ee186e4a22",
     "status": "RUNNING",
     "number": 2,
+    "type": "replica_update",
     "tasks": [
       {
         "created_at": "2019-07-23T17:18:38.000000",

diff --git a/coriolis/api-refs/api_samples/service/service-create-req.json b/coriolis/api-refs/api_samples/service/service-create-req.json
@@ -1,8 +1,8 @@
 {
     "service": {
         "host": "coriolis-worker-ONbgH1NV",
-        "binary": "coriolis-worker",
-        "topic": "coriolis_worker",
+        "binary": "coriolis-worker-test",
+        "topic": "coriolis_worker-test",
         "mapped_regions": ["5e31066c-3512-4e8d-9e68-0a5de3d35c5f"],
         "enabled": false
     }

diff --git a/coriolis/api-refs/api_samples/service/service-create-resp.json b/coriolis/api-refs/api_samples/service/service-create-resp.json
@@ -6,8 +6,8 @@
         "deleted": "0",
         "id": "07c3343b-970d-437a-b670-e88e78dab3fc",
         "host": "coriolis-worker-ONbgH1NV",
-        "binary": "coriolis-worker",
-        "topic": "coriolis_worker",
+        "binary": "coriolis-worker-test",
+        "topic": "coriolis_worker-test",
         "enabled": false,
         "status": "UP",
         "providers": {

diff --git a/coriolis/api-refs/source/diagnostics.inc b/coriolis/api-refs/source/diagnostics.inc
@@ -29,7 +29,10 @@ Response
   - os_info : diagnostic_os_info
   - hostname : diagnostic_hostname
   - ip_addresses : diagnostic_ip_addresses
+  - licensing_status : diagnostic_licensing_status
   - packages : diagnostic_packages
+  - licences : diagnostic_licences
+  - reservations : diagnostic_reservations
 
 **Example of a Diagnostics List**