Description
You can call this operation to modify a replica of a tenant.
Call description
Prerequisite
You have passed the authentication for the OCP application service.
Request path
POST /api/v2/ob/clusters/{id}/tenants/{tenantId}/modifyReplica
Path parameters
Parameter |
Type |
Required |
Example value |
Description |
|---|---|---|---|---|
| id | Long | Yes | 1 | The ID of the cluster to which the tenant belongs. |
| tenantId | Long | Yes | 1 | The ID of the tenant. |
Request parameters
Parameter |
Type |
Required |
Example value |
Description |
|---|---|---|---|---|
| zoneName | String | Yes | foo | The name of the tenant, which is unique in the cluster. |
| replicaType | String | No | FULL | The type of the replica. Valid values: |
| resourcePool | Object | No | -- | -- |
| ├─unitSpecName | Object | No | S1 | The unit specifications. You can view the unit specifications on the Unit Specification Management page. |
| ├─unitCount | Integer | No | 1 | The number of units. |
Response parameters
Basic data structure
Parameter |
Type |
Description |
|---|---|---|
| data | Object | The information about the created tenant and asynchronous DAG tasks. For more information, see Task information. |
| successful | Boolean | Indicates whether the request was successful. |
| timestamp | Datetime | The timestamp when the server completed the request. |
| duration | Integer | The time taken by the server to process the request, in milliseconds. |
| status | Integer | An HTTP status code. |
| traceId | String | The trace ID of the request. This trace ID is used for troubleshooting. |
| server | String | The address of the application server that responded to the request. |
Examples
Sample request
POST /api/v2/ob/clusters/1/tenants/2/modifyReplica
body:
[
{
"zoneName": "zone1",
"replicaType": "FULL",
"resourcePool": {
"unitSpecName": "S1",
"unitCount": 1
}
}
]
Sample response
{
"data": {
"cluster": {
"id": 20,
"name": "ob_upgrade",
"obClusterId": 20
},
"context": "Context(parallelIdx=-1, stringMap={tenant_id=3, cluster_id=20, zone_name=zone2}, listMap={})",
"creator": {
"id": 100,
"name": "admin"
},
"id": 94494,
"name": "Modify tenant replica",
"startTime": "2021-03-01T15:12:07.419+08:00",
"status": "RUNNING",
"tasks": [
{
"description": "Wait alter locality",
"downstreams": [
112165
],
"id": 112163,
"name": "Wait alter locality",
"operation": "EXECUTE",
"status": "PENDING",
"upstreams": [
112164
]
},
{
"description": "Prepare alter tenant",
"downstreams": [
112163
],
"id": 112164,
"name": "Prepare alter tenant",
"operation": "EXECUTE",
"status": "RUNNING",
"upstreams": [
]
},
{
"description": "Sync tenant information",
"downstreams": [
112166
],
"id": 112165,
"name": "Sync tenant information",
"operation": "EXECUTE",
"status": "PENDING",
"upstreams": [
112163
]
},
{
"description": "Update tenant status",
"downstreams": [
],
"id": 112166,
"name": "Update tenant status",
"operation": "EXECUTE",
"status": "PENDING",
"upstreams": [
112165
]
}
],
"tenant": {
"id": 3,
"name": "tenant1"
}
},
"duration": 406,
"server": "a83ad33525",
"status": 200,
"successful": true,
"timestamp": "2021-03-01T15:12:07.449+08:00",
"traceId": "71f24180979c487b"
}