Importing a Host to an Environment
Function
This API is used to import a host to an environment.
Calling Method
For details, see Calling APIs.
URI
POST /v1/applications/{application_id}/environments/{environment_id}/hosts/import
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
application_id |
Yes |
String |
Application ID |
environment_id |
Yes |
String |
Environment ID |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
Content-Type |
Yes |
String |
Message body type (format). |
X-Auth-Token |
Yes |
String |
User token. It can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
group_id |
Yes |
String |
Host cluster ID |
host_ids |
Yes |
Array of strings |
ID list of the hosts to be imported |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
status |
String |
Request success or failure status |
result |
Array of strings |
ID list of the imported hosts |
Example Requests
https://{endpoint}/v1/applications/43943381f7764c52baae8e697720873f/environments/666ec038a53c4b9f899823747a7130e8/hosts/import { "group_id" : "4b0cb2f098174d38b0c15645c13eae6f", "host_ids" : [ "8e1eb7f010d4442ca150e3a1a5d96d94" ] }
Example Responses
Status code: 200
OK: The request is successful.
{ "status" : "success", "result" : [ "c5fa45c92c0849229d003d98f52617eb" ] }
Status Codes
Status Code |
Description |
---|---|
200 |
OK: The request is successful. |
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.