The CloudM Migrate API allows third party applications (usually developed by you as the customer) to communicate with CloudM Migrate. This allows you to automate and run migration processes from your own application, without requiring you to log in to the CloudM Migrate user interface.
CloudM do not take any responsibility or liability for the development, use or ongoing maintenance of any third party application that connects to CloudM Migrate via the API.
Prerequisites
First, download SQL Server Management Studio .
You will be required to change the Role within SQL Server to Super Admin. This will allow the user to log in to the CloudM Migrate API.
To change the Role ID:
- Click the Start icon on the desktop of your PC,
- Open SQL Server,
- Navigate to DB > Tables > Users Table > RoleID,
- Right click on the dbo.Users table and select Edit Top 200 Rows,
- In the table, find the desired user login email in the Login column,
- In this row, change the Role ID from "2" to "1" for Super Admin.
- Save the table to confirm any changes.
Configuring the CloudM Migrate API
The CloudM Migrate API Open API specification can be found here.
- Open a browser and enter https://cloudm.local/swagger (replacing cloudm.local with your CloudM domain name). This will open the Swagger UI that you can use to configure access to the CloudM Migrate API from your own application.
- Select AuthenticationAPI.
- On the Authentication API screen, go to the /api/automation/token section.
- In the Parameters section, click on the Example value field to populate the model field with the correct data format,
- Change the Login and Password values from "string" to your CloudM Migrate Login and Password.
- Once a valid login and password has been entered, click on Try it out. If the data is valid, an access token will be generated which you should copy. The token expires after 10 hours.
- In the upper right corner of the screen, in the api_key field, enter bearer, followed by a space, followed by the saved access key. This is case sensitive and the space in between is essential
- Click the Explore button next to the field.
Get a list of your created migrations
In the Swagger UI:
- Navigate to MigrationAPI > /api/automation/migration
- Select the Try it out button.
- The following report will be generated where:
- id = The ID of the configuration,
- projectId = The ID of the project that the current configuration belongs to,
- name = The name of the configuration
Get details of an existing migration
To get details of an existing migration:
- You will need the copy the id of the required configuration (as requested in the section above),
- Navigate to MigrationAPI > /api/automation/migration/{id},
- Enter the id in the id value field (under Parameters),
- Select the Try it out button.
- This will provide the following report on the existing migration (in the Response Body section), and will include (amongst others) ID, Project ID, Name, Source Platform, Destination Platform, Migration Process State and the Creation Date.