yexinru/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
Files
3621d07131907ddfe020578d2cdbc4f0b81064ba
doc-exports/docs/ims/dev/en-us_topic_0110300595.html
Hasko, Vladimir 3621d07131 Initial import of IMS DEV 
Reviewed-by: Kucerak, Kristian <kristian.kucerak@t-systems.com>
Co-authored-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-committed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
2022-09-20 07:04:29 +00:00

4.0 KiB
Raw Blame History

Querying Tenants

Scenario

Tenants with whom you have shared an image can be filtered using search criteria and displayed in a list.

The token obtained from IAM is valid for only 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.

Involved APIs

If you use a token for authentication, you must obtain the token and add X-Auth-Token to the request header of the IMS API when making an API call.

  • IAM API used to obtain the token

    URI format: POST https://IAM endpoint/v3/auth/tokens

  • IMS API used to query image members (Native OpenStack API)

    URI format: GET https://IMS endpoint/v2/images/Image ID/members

Procedure

  1. Obtain the token.
  2. Send GET https://IMS endpoint/v2/images/Image ID/members/.
  3. Add X-Auth-Token to the request header.
  4. Check the response parameters.
    {
    "status": "accepted",  //Sharing status (accepted indicates that the shared image will be accepted.)
    "created_at": "2016-09-01T02:05:14Z",  //Time when the image is shared
    "updated_at": "2016-09-01T02:37:11Z",  //Time when the image is updated
    "image_id": "d164b5df-1bc3-4c3f-893e-3e471fd16e64",  //Image ID
    "member_id": "edc89b490d7d4392898e19b2deb34797"  //Member ID (that is, project ID of the image recipient)
    "schema": "/v2/schemas/member"  //Image sharing schema
}

    For details about status codes for request exceptions, see Status Codes.

Parent topic: Sharing an Image