Adding Image Recipients

Function

This is an extended API used to share more than one image with multiple users.

This is an asynchronous API. If job_id is returned, the job is successfully delivered. You need to query the status of the asynchronous job. If the status is success, the job is successfully executed. If the status is failed, the job fails. For details about how to query an asynchronous job, see Querying the Progress of an Asynchronous Job.

Huawei Cloud has stopped providing Windows images. This API will no longer be used to share Windows images.

Debugging

You can debug this API in API Explorer.

Authorization

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. For details about the required permissions, see Permissions and Supported Actions.

URI

POST /v1/cloudimages/members

Request

• Request parameters

  Parameter	Mandatory	Type	Description
  images	Yes	Array of strings	Definition Image IDs. For details about how to obtain them, see Querying Images. Constraints N/A
  projects	Yes	Array of strings	Definition Project IDs. For details about how to obtain a project ID, see Obtaining a Project ID. Constraints At least one of projects, domains, or organizations must be specified.
  domains	No	Array of strings	Definition Account IDs. For details about how to obtain an account ID, see Obtaining a Project ID, Account ID, or Organization URN. Constraints At least one of projects, domains, or organizations must be specified.
  organizations	No	Array of strings	Definition Organization URNs. A URN uniquely identifies a cloud service resource. For details about how to obtain it, see Viewing Details About an Organization. Constraints At least one of projects, domains, or organizations must be specified.

  

  At least one of projects, domains, and organizations must be specified.

Example Request

Adding tenants who can use shared images (image IDs: d164b5df-1bc3-4c3f-893e-3e471fd16e64, 0b680482-acaa-4045-b14c-9a8c7dfe9c70; project IDs: 9c61004714024f9586705d090530f9fa, edc89b490d7d4392898e19b2deb34797)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

POST https://{Endpoint}/v1/cloudimages/members
{
    "images": [
        "d164b5df-1bc3-4c3f-893e-3e471fd16e64",
        "0b680482-acaa-4045-b14c-9a8c7dfe9c70"
    ],
    "projects": [
        "9c61004714024f9586705d090530f9fa",
        "edc89b490d7d4392898e19b2deb34797"
    ]
}

Response

• Response parameters

  Parameter	Type	Description
  job_id	String	Definition Asynchronous job ID. For details, see Querying the Progress of an Asynchronous Job. Range N/A

• Example response

  STATUS CODE 200

  1 2 3

  { "job_id": "edc89b490d7d4392898e19b2deb34797" }

Returned Values

• Normal

  200

• Abnormal

  Returned Value	Description
  400 Bad Request	Request error. For details, see Error Codes.
  401 Unauthorized	Authentication failed.
  403 Forbidden	Insufficient permissions.
  404 Not Found	Requested resource not found.
  500 Internal Server Error	Internal service error.
  503 Service Unavailable	Service unavailable.