Changing the Security Group for a CBH Instance
Function
This API is used to change the security group for a CBH instance.
URI
PUT /v2/{project_id}/cbs/instance/{server_id}/security-groups
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. For details about how to obtain the project ID, see "Obtaining a Project ID." |
server_id |
Yes |
String |
CBH instance ID, in UUID format. For details about how to obtain the value, see " Viewing CBH Instance Details" in Cloud Bastion Host User Guide. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. You can obtain it by calling the IAM API. The value of X-Subject-Token in the response header is the user token. For details, see "Obtaining the Token of an IAM User." |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
security_groups |
Yes |
Array of strings |
Security group information. |
Response Parameters
Status code: 200
Change Instance SecurityGroups Success
Status code: 400
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code |
error_description |
String |
Incorrect request parameters. |
Status code: 401
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code |
error_description |
String |
Failed to verify the token. |
Status code: 403
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code |
error_description |
String |
Permissions required. |
Status code: 404
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code |
error_description |
String |
Not CBH instances found. |
Example Requests
{ "security_groups" : [ "4967c8c3-xxxx-xxxx-xxxx-ee9638683471", "a78a0603-xxxx-xxxx-xxxx-e1313589137e" ] }
Example Responses
None
Status Codes
Status Code |
Description |
---|---|
200 |
Change Instance SecurityGroups Success |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
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.