Transfer Resources
1. API Description
Use this API to transfer resource ownership to another user or account.
2. API URL
POST http://{anymetrics_host:anymetrics_port}/anymetrics/api/v1/resourceVersion/transfer
To obtain anymetrics_host:anymetrics_port, see Calling APIs.
3. Request Parameters
3.1 Common Request Headers
| Parameter | Type | Required | Description |
|---|---|---|---|
| tenant-id | String | Yes | Tenant ID that identifies the tenant to which the resource belongs. |
| auth-type | String | Yes | Authentication type. Supported values: UID, TOKEN, ACCOUNT, APIKEY. |
| auth-value | String | Yes | Authentication value corresponding to auth-type. |
3.1.1 How to Obtain Common Parameters
In Aloudata CAN, select the metric application from the top navigation bar, then choose API Integration from the left navigation menu. You can obtain tenant-id on the API Integration page. Set auth-value to the authentication value required by the selected auth-type.
3.2 Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| resourceIds | Array |
Yes | List of resource IDs to transfer. |
| resourceType | String | Yes | Resource type, for example METRIC. |
| targetOwner.identityType | String | Yes | USER_ACCOUNT: id is an account. Other values: id is a user ID. |
| targetOwner.id | String | Yes | Target owner account or user ID. |
4. Request Example
curl --location 'http://localhost:8083/anymetrics/api/v1/resourceVersion/transfer' \
--header 'tenant-id: tn_xxx' \
--header 'auth-value: 492376865890107392' \
--header 'auth-type: UID' \
--header 'Content-Type: application/json' \
--data '{
"resourceIds": [
"mc2db8445b3a7148b7bc6ba8b853aa44"
],
"resourceType": "METRIC",
"targetOwner": {
"identityType": "USER_ACCOUNT",
"id": "canlll"
}
}'