Adding a Share Member
Function
This API is used to add a member with whom the backup can be shared. Only cloud server backups can be shared among tenants in the same region.
URI
POST /v3/{project_id}/backups/{backup_id}/members
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
backup_id |
Yes |
String |
Backup ID |
project_id |
Yes |
String |
Project ID |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. Obtained by calling the corresponding IAM API. If the request is successfully processed, the value of X-Subject-Token included in the response header is the token value. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
members |
Yes |
Array of strings |
List of project IDs of the backup share members to be added. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
members |
Array of Member objects |
Response parameters of adding a backup share member |
count |
Integer |
Parameter |
Type |
Description |
---|---|---|
status |
String |
Backup sharing status Enumeration values:
|
created_at |
String |
Backup sharing time, for example, 2020-02-05T10:38:34.209782 |
updated_at |
String |
Update time, for example, 2020-02-05T10:38:34.209782 |
backup_id |
String |
Backup ID |
image_id |
String |
ID of the image created by using the accepted shared backup |
dest_project_id |
String |
ID of the project with which the backup is shared |
vault_id |
String |
ID of the vault where the shared backup is stored |
id |
String |
ID of the shared record |
Example Requests
POST https://{endpoint}/v3/0605767b5780d5762fc5c0118072a564/backups/0b07081e-3ec7-4e77-8571-54e2947da422/members { "members" : [ "075e6035d300d48c2fd0c00b78b71ebf" ] }
Example Responses
Status code: 200
OK
{ "members" : [ { "status" : "pending", "backup_id" : "0b07081e-3ec7-4e77-8571-54e2947da422", "dest_project_id" : "075e6035d300d48c2fd0c00b78b71ebf", "created_at" : "2020-02-05T10:38:34.209782", "id" : "3c5a3015-c3a0-4dc6-a1e2-917b90f62319" } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
OK |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot