ac165112b7
In microversion 2.80, the ``GET /os-migrations`` API will have
optional ``user_id`` and ``project_id`` query parameters for
filtering migrations by user and/or project:
* GET /os-migrations?user_id=ef9d34b4-45d0-4530-871b-3fb535988394
* GET /os-migrations?project_id=011ee9f4-8f16-4c38-8633-a254d420fd54
* GET /os-migrations?user_id=ef9d34b4-45d0-4530-871b-3fb535988394&project_id=011ee9f4-8f16-4c38-8633-a254d420fd54
And expose the ``user_id`` and ``project_id`` fields in the following APIs:
* GET /os-migrations
* GET /servers/{server_id}/migrations
* GET /servers/{server_id}/migrations/{migration_id}
Co-Authored-By: Qiu Fossen <qiujunting>
Part of blueprint add-user-id-field-to-the-migrations-table
Change-Id: I7313d6cde1a5e1dc7dd6f3c0dff9f30bbf4bee2c
84 lines
2.2 KiB
ReStructuredText
84 lines
2.2 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
=========================================
|
|
Migrations (os-migrations)
|
|
=========================================
|
|
|
|
Shows data on migrations.
|
|
|
|
List Migrations
|
|
===============
|
|
|
|
.. rest_method:: GET /os-migrations
|
|
|
|
Lists migrations.
|
|
|
|
Policy defaults enable only users with the administrative role to perform
|
|
this operation. Cloud providers can change these permissions through the
|
|
``policy.json`` file.
|
|
|
|
Starting from microversion 2.59, the response is sorted by ``created_at``
|
|
and ``id`` in descending order.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- hidden: migration_hidden
|
|
- host: migration_host
|
|
- instance_uuid: migration_instance_uuid
|
|
- migration_type: migration_type
|
|
- source_compute: migration_source_compute
|
|
- status: migration_status
|
|
- limit: migration_limit
|
|
- marker: migration_marker
|
|
- changes-since: changes_since_migration
|
|
- changes-before: changes_before_migration
|
|
- user_id: user_id_query_migrations
|
|
- project_id: project_id_query_migrations
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- migrations: migrations
|
|
- created_at: created
|
|
- dest_compute: migrate_dest_compute
|
|
- dest_host: migrate_dest_host
|
|
- dest_node: migrate_dest_node
|
|
- id: migration_id
|
|
- instance_uuid: server_id
|
|
- new_instance_type_id: migration_new_flavor_id
|
|
- old_instance_type_id: migration_old_flavor_id
|
|
- source_compute: migrate_source_compute
|
|
- source_node: migrate_source_node
|
|
- status: migrate_status
|
|
- updated_at: updated
|
|
- migration_type: migration_type_2_23
|
|
- links: migration_links_2_23
|
|
- uuid: migration_uuid
|
|
- migrations_links: migration_next_links_2_59
|
|
- user_id: user_id_migration_2_80
|
|
- project_id: project_id_migration_2_80
|
|
|
|
**Example List Migrations: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-migrations/migrations-get.json
|
|
:language: javascript
|
|
|
|
**Example List Migrations (v2.80):**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-migrations/v2.80/migrations-get.json
|
|
:language: javascript
|
|
|
|
**Example List Migrations With Paging (v2.80):**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-migrations/v2.80/migrations-get-with-limit.json
|
|
:language: javascript
|