All Products
Search

This Product

    Object Storage Service:GetUserAntiDDosInfo

    Document Center

    Object Storage Service:GetUserAntiDDosInfo

    Last Updated:Apr 29, 2024

    Queries Anti-DDoS instances.

    Usage notes

    By default, an Alibaba Cloud account has the permissions to query Anti-DDoS instances. To query Anti-DDoS instances by using a RAM user or Security Token Service (STS), you must have the oss:GetUserAntiDDosInfo permission. For more information, see Common examples of RAM policies.

    Request syntax

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

    Request headers

    All headers in a GetUserAntiDDosInfo request are common request headers. For more information, see Common HTTP headers.

    Response headers

    All headers in the response to a GetUserAntiDDosInfo request are common response headers. For more information, see Common HTTP headers.

    Response elements

    Element

    Type

    Example

    Description

    AntiDDOSListConfiguration

    Container

    N/A

    The container that stores the list of Anti-DDoS instances.

    Parent nodes: none

    Child nodes: Marker, IsTruncated, and AntiDDOSConfiguration

    AntiDDOSConfiguration

    Container

    N/A

    The container that stores information about the Anti-DDoS instance.

    Parent node: AntiDDOSListConfiguration

    Child nodes: InstanceId, Bucket, Owner, Ctime, Mtime, and Status

    InstanceId

    String

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

    The ID of the Anti-DDoS instance.

    Parent nodes: AntiDDOSConfiguration

    Child nodes: none

    Owner

    String

    114893010724****

    The ID of the owner of the Anti-DDoS instance.

    Parent nodes: AntiDDOSConfiguration

    Child nodes: none

    Ctime

    String

    1626769503

    The time when the Anti-DDoS instance was created. The value is a timestamp.

    Parent nodes: AntiDDOSConfiguration

    Child nodes: none

    Mtime

    String

    1626769840

    The time when the Anti-DDoS instance was last updated. The value is a timestamp.

    Parent nodes: AntiDDOSConfiguration

    Child nodes: none

    ActiveTime

    String

    1626769845

    The time when the Anti-DDoS instance was activated. The value is a timestamp.

    Parent nodes: AntiDDOSConfiguration

    Child nodes: none

    Status

    String

    Defending

    The status of the Anti-DDoS instance.

    • Init

    • Defending

    • HaltDefending

    Parent nodes: AntiDDOSConfiguration

    Child nodes: none

    Examples

    • Sample requests

    GET /?antiDDos HTTP/1.1
Date:  Fri, 04 Mar 2022 05:34:24 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************

    • Sample responses

    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****

<AntiDDOSListConfiguration>    
    <AntiDDOSConfiguration>        
        <InstanceId>cbcac8d2-4f75-4d6d-9f2e-c3447f73****</InstanceId>
        <Owner>114893010724****</Owner> 
        <Ctime>12345667</Ctime>
        <Mtime>12345667</Mtime>
        <ActiveTime>12345680</ActiveTime>
        <Status>Init</Status>
    </AntiDDOSConfiguration>
 </AntiDDOSListConfiguration>