All Products
Search
Document Center

Alibaba Cloud DNS:DeleteAtiAgentRegisterInfo

Last Updated:Aug 28, 2026

Deletes Agent registration information.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ClientToken

string

No

Ensures the idempotency of the request. Generate a parameter value from your client to ensure uniqueness across different requests. ClientToken supports only ASCII characters and cannot exceed 64 characters in length.

Note

If you do not specify this parameter, the system automatically uses the RequestId of the API request as the ClientToken. The RequestId may vary for each API request.

eyJhbGciOiJIUzI1NiIsInR5cC.....

AgentRegisterInfoId

string

Yes

The AgentRegisterInfoId is automatically generated by the Alibaba Cloud ATS platform and is globally unique. Call the query operation to obtain this ID, and then use it to delete the Agent.

2074031103110331392

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

RequestId

B57C121B-A45F-44D8-A9B2-13E5A5044195

Success

boolean

Indicates whether the operation was successful:

  • true: The operation was successful.

  • false: The operation failed.

true

AccessDeniedDetail

object

The details about the access denial. This field is returned only when RAM authentication fails.

AuthAction

string

The unauthorized operation that was attempted.

RemoveRspDomainServerHoldStatusForGateway

AuthPrincipalDisplayName

string

The display name of the authorization principal.

2015555733387XXXX

AuthPrincipalOwnerId

string

The owner ID of the authorization principal.

10469733312XXX

AuthPrincipalType

string

The identity type.

SubUser

EncodedDiagnosticMessage

string

The encoded diagnostic message.

AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==

NoPermissionType

string

The reason for the authentication failure. Valid values:

  • ExplicitDeny: explicit deny.

  • ImplicitDeny: implicit deny.

ImplicitDeny

PolicyType

string

The policy type.

DlpSend

Examples

Success response

JSON format

{
  "RequestId": "B57C121B-A45F-44D8-A9B2-13E5A5044195",
  "Success": true,
  "AccessDeniedDetail": {
    "AuthAction": "RemoveRspDomainServerHoldStatusForGateway",
    "AuthPrincipalDisplayName": "2015555733387XXXX",
    "AuthPrincipalOwnerId": "10469733312XXX",
    "AuthPrincipalType": "SubUser",
    "EncodedDiagnosticMessage": "AQFohtp4aIbaeEXXXXQxNjFDLUIzMzgtNTXXXX05NkFCLUI2RkY5XXXXzAzQQ==",
    "NoPermissionType": "ImplicitDeny",
    "PolicyType": "DlpSend"
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.