1. Interface Description
Interface request domain name: vpc.api3.convergecloud.com.
This API is used to create a security group.
- The security group quantity limit applies to each project in each region under each account.
- The inbound and outbound policies of the created security group are set to deny all by default. After creation, you typically need to call CreateSecurityGroupPolicies to configure the policies as needed.
- Tags can be bound to the security group during its creation. The tag list in the response represents the successfully added tags.
Default interface request rate limit: 100 times per second.
Interface update time: 2020-02-14 00:24:38.
The interface only verifies the signature but does not authenticate.
2. Input Parameters
The following list of request parameters only lists interface request parameters and some public parameters, For a complete list of public parameters see public request parameters.
| Parameter name | Required | Allow NULL | Type | Description |
|---|---|---|---|---|
| Action | Yes | No | String | Public parameter, The value of this interface: CreateSecurityGroup |
| Version | Yes | No | String | Public parameter, The value of this interface: 2017-03-12 |
| Region | No | No | String | Public parameter,Regional information A list of supported geographies is available through the DescribeRegions interface |
| ProjectId | No | No | String | Project ID. Default value: 0. It can be queried on the project management page in the console. Example: 0 |
| GroupName | Yes | No | String | Security group name. The name can be given freely but must not exceed 60 characters. Example: demoGroup |
| GroupDescription | Yes | No | String | Security group remarks, up to 100 characters. Example: demo-group-desc |
| Tags | No | No | Array of Tag | Specifies the list of tags for binding. For example, [{"Key": "city", "Value": "region"}]. Example:View |
3. Output Parameters
| Parameter name | Type | Description |
|---|---|---|
| SecurityGroup | SecurityGroup | Security group object. Example:View |
| RequestId | String | Unique request id, Each request will return. The RequestId of the request needs to be provided when locating the problem. |
4. Error Code
The following lists only the error codes related to the interface business logic, For other error codes, see public ErrorCode.
| Error Code | Description |
|---|---|
| InvalidParameter | Invalid input parameters. |
| LimitExceeded | Exceeded the limit |
| InvalidParameterValue.Malformed | Invalid input format. |
| ResourceNotFound | The resource does not exist |
| InvalidParameterValue.LimitExceeded | The parameter value exceeds the limit. |
| MissingParameter | Missing parameters. The request did not carry the required parameter. |