Associates an endpoint with a security group.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | AttachSecurityGroupToVpcEndpoint |
The operation that you want to perform. Set the value to AttachSecurityGroupToVpcEndpoint. |
EndpointId | String | Yes | ep-hp33b2e43fays7s8**** |
The ID of the endpoint that you want to associate with the security group. |
RegionId | String | Yes | eu-west-1 |
The ID of the region where the endpoint is created. You can call the DescribeRegions operation to query region IDs. |
SecurityGroupId | String | Yes | sg-hp3c8qj1tyct90ej**** |
The ID of the security group with which you want to associate the endpoint. |
DryRun | Boolean | No | false |
Specifies whether to only check the API request. Valid values: true: only checks the API request. If you select this option, the endpoint is not associated
with the security group after the request passes the check. Check items include whether
the AccessKey pair is valid, whether the RAM user is authorized, and whether the required
parameters are specified. If the request fails to meet the requirements in the check
items, an error message is returned. If the request meets the requirements in the
check items, the false (default): checks the API request. After the request passes the check, the 2XX HTTP status code is returned, and the endpoint is associated with the security group. |
ClientToken | String | No | 0c593ea1-3bea-11e9-b96b-88e9fe637760 |
The client token that is used to ensure the idempotence of the request. You can use the client to generate a value that is unique among different requests. ClientToken can contain only ASCII characters and cannot exceed 64 characters in length. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 8D778FF9-7640-4C13-BCD6-9265CA9A2F81 |
The ID of the request. |
Examples
Sample requests
https://[Endpoint]/?Action=AttachSecurityGroupToVpcEndpoint
&EndpointId=ep-hp33b2e43fays7s8****
&RegionId=eu-west-1
&SecurityGroupId=sg-hp3c8qj1tyct90ej****
&<Common request parameters>
Sample success responses
XML
format
<AttachSecurityGroupToVpcEndpointResponse>
<RequestId>8D778FF9-7640-4C13-BCD6-9265CA9A2F81</RequestId>
</AttachSecurityGroupToVpcEndpointResponse>
JSON
format
{
"RequestId": "8D778FF9-7640-4C13-BCD6-9265CA9A2F81"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | EndpointNotFound | The specified Endpoint does not exist. | The error message returned because the specified endpoint is not found. |
400 | EndpointOperationDenied | The specified operation of endpoint is not allowed. | The error message returned because the operation is not allowed when the endpoint is being processed. |
400 | EndpointLocked | The specified Endpoint is locked. | The error message returned because the endpoint is locked. |
400 | EndpointConnectionOperationDenied | The endpoint is being connected. | The error message returned because the operation is not allowed when the endpoint connection is being processed. |
400 | SecurityGroupExist | The specified security group already exists. | The error message returned because the specified security group already exists. |
For a list of error codes, visit the API Error Center.