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.
