d7140ffe09
Nowadays "project" and "project_id" are used instead of "tenant" in the OpenStack world. See [1] and [2]. - Replace "tenant_id" in the API paths to "project_id" - For most manila resources, the "project_id" in an API response body refers to the project that owns the resource. So, create a unified parameter and share that across the APIs. - Fix path variable names, and their order - Fix usage of "UUID" to refer to project and user IDs - Fix query parameters [1] https://docs.openstack.org/operations-guide/ops-projects-users.html [2] https://developer.openstack.org/api-ref/identity/v3/index.html#projects Partial-Bug: #1760644 Co-Authored-By: Goutham Pacha Ravi <gouthampravi@gmail.com> Change-Id: I64e4ef8ad258d07c7d80d11a4d015c4b82156722
166 lines
3.3 KiB
ReStructuredText
166 lines
3.3 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
==============================
|
|
User messages (since API 2.37)
|
|
==============================
|
|
|
|
Lists, shows and deletes user messages.
|
|
|
|
User messages are automatically created when an asynchronous action fails on a
|
|
resource. In such situations an error is logged in the appropriate log file but
|
|
end users may not have access to the log files. User messages can be used by
|
|
users to get error details for failed actions. This is handy for example when
|
|
creating shares - if a share creation fails because a scheduling filter doesn't
|
|
find suitable back-end host for the share, this share will end up in error
|
|
state, but from user messages API users can get details about the last
|
|
executed filter which helps them identify the issue and perhaps re-attempt the
|
|
creation request with different parameters.
|
|
|
|
|
|
List user messages
|
|
==================
|
|
|
|
.. rest_method:: GET /v2/{project_id}/messages
|
|
|
|
.. versionadded:: 2.37
|
|
|
|
Lists all user messages.
|
|
|
|
|
|
Response codes
|
|
--------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id_path
|
|
- limit: limit
|
|
- offset: offset
|
|
- sort_key: sort_key_messages
|
|
- sort_dir: sort_dir
|
|
- action_id: action_id
|
|
- detail_id: detail_id
|
|
- message_level: message_level
|
|
- project_id: project_id_messages
|
|
- request_id: request_id
|
|
- resource_id: resource_id
|
|
- resource_type: resource_type
|
|
|
|
Response parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- action_id: action_id_body
|
|
- detail_id: detail_id_body
|
|
- message_level: message_level_body
|
|
- project_id: project_id_messages_body
|
|
- request_id: request_id_body
|
|
- resource_id: resource_id_body
|
|
- resource_type: resource_type_body
|
|
- message_members_links: message_members_links
|
|
|
|
|
|
Response example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/user-messages-list-response.json
|
|
:language: javascript
|
|
|
|
|
|
Show user message details
|
|
=========================
|
|
|
|
.. rest_method:: GET /v2/{project_id}/messages/{message_id}
|
|
|
|
.. versionadded:: 2.37
|
|
|
|
Shows details for a user message.
|
|
|
|
Response codes
|
|
--------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id_path
|
|
- message_id: message_id
|
|
|
|
Response parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- action_id: action_id_body
|
|
- detail_id: detail_id_body
|
|
- message_level: message_level_body
|
|
- project_id: project_id_messages_body
|
|
- request_id: request_id_body
|
|
- resource_id: resource_id_body
|
|
- resource_type: resource_type_body
|
|
- message_links: message_links
|
|
|
|
|
|
Response example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/user-message-show-response.json
|
|
:language: javascript
|
|
|
|
|
|
Delete message
|
|
==============
|
|
|
|
.. rest_method:: DELETE /v2/{project_id}/messages/{message_id}
|
|
|
|
.. versionadded:: 2.37
|
|
|
|
Deletes a user message.
|
|
|
|
Response codes
|
|
--------------
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 202
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- project_id: project_id_path
|
|
- message_id: message_id
|