Show image member details¶
Overview¶
Shows image member details.
Classification¶
- Show
API Operation Object¶
- members
Synchronous / Asynchronous¶
- synchronous
Request¶
HTTP Request Method¶
- GET
HTTP Request Path¶
{api_endpoint}/v2/images/{image_id}/members/{member_id}
HTTP Request Header¶
HTTP Request Body¶
Format¶
- none
Request Parameter¶
| name | style | format | description | required/optional | default value | action for invalid parameter | response code for invalid parameter |
|---|---|---|---|---|---|---|---|
| image_id | URL | UUID | An identifier for the image | required | - | Terminate | 404 |
| member_id | URL | UUID(3) | An identifier for the image member (projectID) | required | - | Terminate | 404 |
| token_id | Header | authentication token string | keystone authentication token | required | - | Terminate | 401 |
Response¶
HTTP Response Header¶
Format¶
HTTP/1.1 <response_code> <message> (ex. 200 OK)
<response_code>: see "HTTP Responses" section
<message>: message based on the response code
- skip auto insert field such as "X-Compute-Request-Id" and "Content-Length", "Date"
Response Code¶
| response code | condition |
|---|---|
| 200 | normal end |
| 401 | unauthorized |
| 404 | specify non-existent image_id |
| - | specify the image_id of deleted image |
| - | specify non-existent member_id |
| - | specify member_id which is not the member of specified image |
| - | specify public image |
| - | if authority of non admin, requested by user whose project is not the member and not the owner of specified private image |
| 500 | Internal Error |
HTTP Response Body¶
Format¶
{
"status": "<member_status>",
"created_at": "<created_time>",
"updated_at": "<updated_time>",
"image_id": "<image_id>",
"member_id": "<member_id>",
"schema": "<member_schema>"
}
Response Parameter¶
| item | format | description |
|---|---|---|
| member_status | String (pending, accepted, rejected) | The status of this image member |
| created_time | time/date | Date and time of image member creation |
| updated_time | time/date | Date and time of last modification of image member |
| image_id | UUID | An identifier for the image |
| member_id | UUID(3) | An identifier for the image member (projectID) |
| member_schema | URL String | URL for schema of the member |
Sample API Request and Response¶
Sample API Request¶
Request URI¶
https://example.com/v2/images/{image_id}/members/{member_id}
Request Body¶
- none
Sample API Response¶
Response Header¶
HTTP/1.1 200 OK
<response_code>: see "HTTP Responses" section
<message>: message based on the response code
- skip auto insert field such as "X-Compute-Request-Id" and "Content-Length", "Date"
Response Body¶
{
"status": "<member_status>",
"created_at": "<created_time>",
"updated_at": "<updated_time>",
"image_id": "<image_id>",
"member_id": "<member_id>",
"schema": "<member_schema>"
}
Execution Example¶
HTTP Request¶
GET /v2/images/b74e0497-764d-4b02-8b8b-51c396a7ff5a/members/1efb79fe4437490aab966b57da5b9f05 HTTP/1.1
User-Agent: curl/7.35.0
Host: 192.168.11.141:9292
Accept: */*
X-Auth-Token: 35266111e7c3495d8273f59fdcca8210
HTTP Response¶
HTTP/1.1 200 OK
Content-Length: 231
Content-Type: application/json; charset=UTF-8
X-Openstack-Request-Id: req-b94ff9e7-f2bd-4cdc-b7c0-240054d2484c
Date: Thu, 31 Jul 2014 08:22:49 GMT
{"status": "accepted", "created_at": "2014-07-31T08:03:41Z", "updated_at": "2014-07-31T08:07:17Z", "image_id": "b74e0497-764d-4b02-8b8b-51c396a7ff5a", "member_id": "1efb79fe4437490aab966b57da5b9f05", "schema": "/v2/schemas/member"}
Error Message Example¶
HTTP Request¶
GET /v2/images/b74e0497-764d-4b02-8b8b-51c396a7ff5a/members/1efb79fe4437490aab966b57da5b9f05 HTTP/1.1
User-Agent: curl/7.35.0
Host: 192.168.56.250:8776
X-Auth-Token: b4039009185744c19e95271805a944b5
Accept: application/json
HTTP Response¶
HTTP/1.1 404 Not Found
Content-Length: 52
Content-Type: text/plain; charset=UTF-8
X-Openstack-Request-Id: req-c58b904a-c325-4512-885d-d73bed631126
Date: Thu, 17 Sep 2015 11:44:14 GMT
404 Not Found
The resource could not be found.