Obtaining the Agent Configuration Information
Function
After the Agent installed on a source server is started, it calls this API to obtain configuration information.
Calling Method
For details, see Calling APIs.
URI
GET /v3/config
Request
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
The user token. The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. Minimum length: 1 character Maximum length: 16,384 characters |
Response
Status code: 200
Parameter |
Type |
Description |
---|---|---|
config |
Map<String,String> |
mainRegion, obs_domain, disktype, process_and_it, and information to be added later |
regions |
Array of RegionInfo objects |
The Region array. Array length: 1 - 100 characters |
Status code: 400
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
The error code. Minimum length: 0 characters Maximum length: 255 characters |
error_msg |
String |
The error message. Minimum length: 0 characters Maximum length: 1,024 characters |
Example Request
This example obtains the Agent configuration information under the current endpoint.
GET https://{endpoint}/v3/config
Example Response
Status code: 200
The configuration information obtained.
{ "config" : { "mainRegion" : "ap-southeast-1", "disktype" : "SATA" }, "regions" : [ { "region_name" : "cn-north-1", "project_name" : "cn-north-1" }, { "region_name" : "cn-north-4", "project_name" : "cn-north-4" } ] }
Status Codes
Status Code |
Description |
---|---|
200 |
The configuration information obtained. |
400 |
Obtaining the configuration information failed. |
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.