List image members#

GET /images/{image_id}/members

This operation returns a collection of members (users) with whom the image has been shared. The response conforms to the schema found in Get image members schema.

If a user with whom this image is shared makes this call, the member list contains only information for that user. If a user with whom this image has not been shared makes this call, the response is HTTP 404.

This table shows the possible response codes for this operation:

{
    "members": [
        {
            "created_at": "2013-10-07T17:58:03Z",
            "image_id": "dbc999e3-c52f-4200-bedd-3b18fe7f87fe",
            "member_id": "123456789",
            "schema": "/v2/schemas/member",
            "status": "pending",
            "updated_at": "2013-10-07T17:58:03Z"
        },
        {
            "created_at": "2013-10-07T17:58:55Z",
            "image_id": "dbc999e3-c52f-4200-bedd-3b18fe7f87fe",
            "member_id": "987654321",
            "schema": "/v2/schemas/member",
            "status": "accepted",
            "updated_at": "2013-10-08T12:08:55Z"
        }
    ],
    "schema": "/v2/schemas/members"
}

Get image member details#

GET /images/{image_id}/members/{member_id}

This operation shows details of the image member. The response conforms to the schema found in Get image members schema To get a successful response, either the image owner must make the call or the tenant_id of the user making the call must match the specified member_id. Otherwise the response is HTTP 404.

This table shows the possible response codes for this operation:

{
    "created_at": "2014-02-20T04:15:17Z",
    "image_id": "634985e5-0f2e-488e-bd7c-928d9a8ea82a",
    "member_id": "348129",
    "schema": "/v2/schemas/member",
    "status": "pending",
    "updated_at": "2014-02-20T04:15:17Z"
}

Create image member#

POST /images/{image_id}/members

This operation allows you to add users, by member_id (which is the tenant_id ) to the list of members with whom the image is shared. The member status of a newly created image member is pending. The response conforms to the schema found in Get image members schema.

If the user making the call is not the image owner, the response is HTTP 404.

This table shows the possible response codes for this operation:

{
    "member": "554433"
}

{
    "created_at": "2013-09-20T19:22:19Z",
    "image_id": "a96be11e-8536-4910-92cb-de50aa19dfe6",
    "member_id": "554433",
    "schema": "/v2/schemas/member",
    "status": "pending",
    "updated_at": "2013-09-20T19:25:31Z"
}

Delete image member#

DELETE /images/{image_id}/members/{member_id}

Deletes the specified account ID/tenant ID from the member list of the specified image.

This operation deletes the image member from the image. This call, which can only be made by the image owner, removes users from the list of members who have access to a shared image.

If the {member_id} is not a member of the specified image, the response is HTTP 404

This table shows the possible response codes for this operation:

Update image member#

PUT /images/{image_id}/members/{member_id}

Sets the specified status for the specified member of the specified image.

This operation updates the image member. The response conforms to the schema found in Get image members schema.

If the call is made by the image owner, the response is HTTP 403 (Forbidden).

If the call is made by a user who is not the owner and whose tenant ID is not the same as the {member_id} in the operation URI, the response is HTTP 404.

This table shows the possible response codes for this operation:

{
    "status": "accepted"
}

{
    "created_at": "2013-09-20T19:22:19Z",
    "image_id": "a96be11e-8536-4910-92cb-de50aa19dfe6",
    "member_id": "554433",
    "schema": "/v2/schemas/member",
    "status": "accepted",
    "updated_at": "2013-09-20T20:15:31Z"
}