Creates a probe.
Debugging
Authorization information
The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action
policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:
- Operation: the value that you can use in the Action element to specify the operation on a resource.
- Access level: the access level of each operation. The levels are read, write, and list.
- Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level,
All Resources
is used in the Resource type column of the operation.
- Condition Key: the condition key that is defined by the cloud service.
- Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
Operation | Access level | Resource type | Condition key | Associated operation |
---|---|---|---|---|
yundun-sas:CreateHoneypotProbe | create |
|
| none |
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
ControlNodeId | string | Yes | The ID of the management node. Note
You can call the ListHoneypotNode operation to query the IDs of management nodes.
| a882e590-b87b-45a6-87b9-d0a3e5a0**** |
ProbeType | string | Yes | The type of the probe. Valid values:
| host_probe |
DisplayName | string | Yes | The name of the probe. | testHoneyPotProbe |
ProbeVersion | string | No | The version of the probe. | 0.0.0 |
Uuid | string | No | The UUID of the instance. Note
If ProbeType is set to host_probe, this parameter is required.
| e4af3620-6895-4e2f-a641-a9d8fb53**** |
BusinessGroupId | string | No | The ID of the business group. | 2022011817324588686 |
HoneypotBindList | array<object> | No | The configuration of the probe. | |
HoneypotBindList | object | No | The details of the configuration. | |
BindPortList | array<object> | No | The listener ports. | |
BindPortList | object | No | The listener port. | |
TargetPort | integer | No | The destination port. Note
If HoneypotId is specified, this parameter is required.
| 80 |
StartPort | integer | No | The start of the port range. | 80 |
EndPort | integer | No | The end of the port range. | 90 |
Fixed | boolean | No | Specifies whether the port is a fixed port. Valid values:
| 0 |
BindPort | boolean | No | Specifies whether to bind a port. Valid values:
| true |
HoneypotId | string | No | The ID of the honeypot. Note
You can call the ListHoneypot operation to query the IDs of honeypots.
| 1a5eda2d40f92ac87d6b63e1a5ad4b76fe0d4110c4a3e2fa85438a29ae55**** |
Ping | boolean | No | Specifies whether to enable ping scan. Valid values:
| true |
Arp | boolean | No | Specifies whether to enable Address Resolution Protocol (ARP) spoofing. Valid values:
| true |
VpcId | string | No | The ID of the VPC. Note
If ProbeType is set to vpc_black_hole_probe, this parameter is required. You can call the DescribeVpcHoneyPotList operation to query the IDs of VPCs.
| vpc-zm0asrkpv1q8gnk7mn4dn |
ProxyIp | string | No | The IP address of the proxy. | 192.168.XX.XX |
Response parameters
Examples
Sample success responses
JSON
format
{
"Success": true,
"Code": "200",
"Message": "successful",
"RequestId": "B7A839E8-70AE-591D-8D9E-C5419A2240DB",
"HttpStatusCode": 200,
"HoneypotProbe": {
"ProbeId": "b69e9aa8-2ea8-4c5a-836a-c1fbacff****"
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | AgentNotOnline | The agent not online. | The error message returned because the Security Center agent is offline. Make sure that the Security Center agent is online and try again. |
400 | IllegalParam | Illegal param | - |
400 | NodeNotExist | The control node does not exist. | - |
400 | BindPortAlreadyExist | The specified service port already exists. | - |
400 | MachineNotExist | The machine does not exist. | - |
400 | ProbeAlreadyCreate | The probe has been created. | - |
400 | ProbeNameAlreadyExists | The probe name already exists. | - |
403 | NoPermission | caller has no permission | You are not authorized to do this operation. |
500 | ServerError | ServerError | - |
For a list of error codes, visit the Service error codes.