Help Center/ Image Management Service/ API Reference/ IMS APIs/ Image Sharing/ Querying Details About an Image Sharing Member
Updated on 2025-05-06 GMT+08:00

Querying Details About an Image Sharing Member

Function

This API is used to query details about a member that an image is shared with.

URI

GET /v1/{project_id}/cloudimages/{image_id}/members/{member_id}

Table 1 lists the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Specifies the project ID.

image_id

Yes

String

Specifies the image ID.

member_id

Yes

String

Specifies the member ID.

Request

Request parameters

None

Example Request

Querying details about an image sharing member

GET https://{Endpoint}/v1/1bed856811654c1cb661a6ca845ebc77/cloudimages/d164b5df-1bc3-4c3f-893e-3e471fd16e64/members/edc89b490d7d4392898e19b2deb34797

Response

  • Response parameters

    Parameter

    Type

    Description

    status

    String

    Specifies the image sharing status.

    created_at

    String

    Specifies the time when an image was shared. The value is in UTC format.

    updated_at

    String

    Specifies the time when a shared image was updated. The value is in UTC format.

    image_id

    String

    Specifies the image ID.

    member_id

    String

    Specifies the member ID.

    schema

    String

    Specifies the sharing schema.

    member_type

    String

    Specifies the member type.

    urn

    String

    Specifies the organization URN.

    This field is returned only when member_type is set to organization.

  • Example response
    STATUS CODE 200
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    {
         "status": "accepted",
         "created_at": "2023-08-23T04:09:12Z",
         "updated_at": "2023-08-23T04:09:12Z",
         "image_id": "370befec-a369-475e-a224-44a45927a8fe",
         "member_id": "ou-qdjrky7i07higfa4f6reqv9etybmp4ng",
         "schema": "/v2/schemas/member",
         "member_type": "organization",
         "urn": "organizations::6c031a41eefc480bb60f20c003891fcd:ou:o-z5142zmm6p5cumsxralfljeb3qrwqamd/ou-qdjrky7i07higfa4f6reqv9etybmp4ng"
    }
    

Returned Values

  • Normal

    200

  • Abnormal

    Returned Value

    Description

    400 Bad Request

    Request error.

    401 Unauthorized

    Authentication failed.

    403 Forbidden

    No operation permissions.

    404 Not Found

    Resource not found.

    500 Internal Server Error

    Internal service error.

    503 Service Unavailable

    Service unavailable.