All Products
Search
Document Center

Security Center:DescribeAttachRecords

Last Updated:Feb 20, 2024

Queries the results of automatically connecting applications on Elastic Compute Service (ECS) instances to the application protection feature after the Runtime Application Self-Protection (RASP) agent is installed on the ECS instances.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ApplicationIdstringYes

The application group ID.

64b8b994563c306b4fed****
EcsUUIDListarrayNo

The UUIDs of ECS instances to be queried.

stringNo

The UUID of the ECS instance to be queried.

Note You can call the DescribeCloudCenterInstances operation to query the UUIDs of ECS instances.
cd405430-c027-4937-8398-10152dac****

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

9F4E6157-9600-5588-86B9-38F09067****
AccessListobject []

The results of automatically connecting applications on the ECS instance to the application protection feature.

EcsUUIDstring

The UUID of the ECS instance.

cd405430-c027-4937-8398-10152dac****
AttachSwitchstring

Indicates whether automatic protection is enabled for the applications on the ECS instance. Valid values:

  • ON: Automatic protection is enabled for the applications on the ECS instance.
  • OFF: Automatic protection is disabled for the applications on the ECS instance.
ON
AttachStatelong

The status of connecting applications on the ECS instance to the application protection feature. Valid values:

  • 0: All applications are connected to the application protection feature.
  • 1: Partial applications are connected to the application protection feature.
  • 2: Applications failed to be connected to the application protection feature.
  • 3: Applications are being connected to the application protection feature.
  • 4: Applications are not connected to the application protection feature.
0
InstallStatelong

The status of installing the RASP agent on the ECS instance to enable automatic application connection. Valid values:

  • 0: installed
  • 1: installing
  • 2: installation failed
  • 3: installation timeout
  • 4: uninstalled
  • 5: uninstalling
  • 6: uninstallation failed
  • 7: uninstallation timeout
0
InstallMsgstring

The message that shows the results of installing the RASP agent on the ECS instance.

success

Examples

Sample success responses

JSONformat

{
  "RequestId": "9F4E6157-9600-5588-86B9-38F09067****",
  "AccessList": [
    {
      "EcsUUID": "cd405430-c027-4937-8398-10152dac****",
      "AttachSwitch": "ON",
      "AttachState": 0,
      "InstallState": 0,
      "InstallMsg": "success"
    }
  ]
}

Error codes

HTTP status codeError codeError messageDescription
403NoPermissioncaller has no permissionYou are not authorized to do this operation.
500ServerErrorServerError-

For a list of error codes, visit the Service error codes.