All Products
Search
Document Center

Object Storage Service:Create an Anti-DDoS OSS instance

Last Updated:Jun 10, 2026

Creates an Anti-DDoS instance for OSS.

Usage notes

Alibaba Cloud accounts can create Anti-DDoS instances by default. To use a RAM user or Security Token Service (STS), you must have the oss:InitUserAntiDDosInfo permission. Common examples of RAM policies.

Request syntax

PUT /?antiDDos HTTP/1.1
Date:  GMT Date
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Request headers

This operation uses only common request headers. Common HTTP headers.

Response headers

Header

Type

Example

Description

x-oss-defender-instance

String

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

The Anti-DDoS instance ID.

The response also includes common headers such as x-oss-request-id and Content-Type. Common HTTP headers.

Examples

  • Sample request

PUT /?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
  • Sample response

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 04 Mar 2022 05:34:24 GMT
Connection: keep-alive
x-oss-request-id: 534B371674E88A4D8906****
x-oss-defender-instance: cbcac8d2-4f75-4d6d-9f2e-c3447f73****