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.