How to change the status of an Anti-DDoS instance by calling UpdateUserAntiDDosInfo - Object Storage Service

Changes the status of an Anti-DDoS instance.

Note

By default, an Alibaba Cloud account has the permissions to change the status of an Anti-DDoS instance. To perform this operation as a RAM user or by using Security Token Service (STS), you must have the oss:UpdateUserAntiDDosInfo permission. For more information, see Common examples of RAM policies.

Request syntax

POST /?antiDDos HTTP/1.1
Date:  GMT Date
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-defender-status: HaltDefending

Request headers

Header

Type

Required

Example

Description

x-oss-defender-instance

String

Yes

cbcac8d2-4f75-4d6d-9f2e-c3447f73****

The ID of the Anti-DDoS instance.

x-oss-defender-status

String

Yes

HaltDefending

The new status of the Anti-DDoS instance. Set the value to

HaltDefending

For more information about common request headers such as Host and Date, see Common HTTP headers.

Response headers

This operation returns only common response headers. For more information, see Common HTTP headers.

Example

Sample request

POST /?antiDDos HTTP/1.1
Date:  Thu, 17 Apr 2025 05:34:24 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****
x-oss-defender-status: HaltDefending

Sample response

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 04 Mar 2022 05:34:24 GMT
Content-Length: 0
Connection: keep-alive
x-oss-request-id: 534B371674E88A4D8906****