Call the ReinstallCollector to retry the installation of the collector that was not successfully installed at the time of creation.
Debugging
Request header
This operation uses only the common request header. For more information, see Common request parameters.
Request structure
POST /openapi/collectors/[ResId]/actions/reinstall HTTP/1.1
Request parameters
Parameter | Type | Position | Required | Example | Description |
---|---|---|---|---|---|
ResId | String | Path | Yes | ct-cn-l871nd0u73c45**** |
The collector ID. |
ClientToken | String | Query | No | 5A2CFF0E-5718-45B5-9D4D-70B3FF**** |
This parameter is used to ensure the idempotence of the request. The value of this parameter is generated by the client and is unique among different requests. The maximum length is 64 ASCII characters. |
RequestBody
The following parameters must be filled in the RequestBody to specify the information of the machine that retries installing the collector.
Parameter |
Type |
Required |
Example |
Description |
---|---|---|---|---|
nodes |
List<String\> |
Yes |
["ecs-cn-abc"] |
The ID of the ECS instance to be retried to install the collector. |
restartType |
String |
Yes |
nodeEcsId |
The type of the retry installation collector. Currently, only nodeEcsId is supported, indicating an ECS instance. |
Example:
{ "restartType": "nodeEcsId", "nodes":["i-bp1gyhphjaj73jsr****","i-bp10piq1mkfnyw9t****"] }
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1**** |
The ID of the request. |
Result | Boolean | true |
Request result:
|
Examples
Sample requests
POST /openapi/collectors/ct-cn-l871nd0u73c45 **** /actions/reinstall HTTP/1.1 public request header {"restartType": "nodeEcsId", "nodes": ["i-bp1gyhphjaj73jsr****","i-bp10piq1mkfnyw9t****"] }
Sample success responses
JSON
format
{ "Result": true, "RequestId": "F18CF67E-633D-41E8-9172-7DE08052****" }
Error codes
For a list of error codes, visit the API Error Center.