AbuseSignal

Client

class AbuseSignal.Client

A low-level client representing AWS Abuse Signal API

Amazon Web Services Abuse Signal API provides programmatic means to report suspected abuse of Amazon Web Services resources. You can use the API to submit abuse reports about Amazon Web Services resources and to track the status of your reports. Amazon Web Services Trust & Safety uses the information that you provide to investigate and try to resolve the incident that you reported.

You submit reports in the eXtended Abuse Reporting Format (XARF), an open standard for structured abuse reporting. For more information, see XARF on the XARF website. Reports can cover a wide range of abuse categories, including spam, phishing, distributed denial of service (DDoS), malware distribution, and copyright infringement.

With the Amazon Web Services Abuse Signal API, you can:

  • Submit abuse reports – Create structured abuse reports by using the XARF format, with full support for all XARF v4 report types.

  • Track report status – Monitor the processing status of submitted reports, from submission through resolution.

  • List and filter reports – Retrieve the status of all reports, with optional filtering by correlation ID.

  • Retry submissions safely – Safely retry report submissions without creating duplicates by using client tokens.

Warning

Cross-Region data residency: By submitting a report, you instruct Amazon Web Services to store it in all supported Regions ( us-east-1, us-west-2, and eu-west-2), including across the United States and Europe. If data must remain in a single Region, do not include it in the report.

client = session.create_client('abuse-signal')

These are the available methods:

Client Exceptions

Client exceptions are available on a client instance via the exceptions property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.

The available client exceptions are:

Paginators

Paginators are available on a client instance via the get_paginator method. For more detailed instructions and examples on the usage of paginators, see the paginators user guide.

The available paginators are:

Waiters

Waiters are available on a client instance via the get_waiter method. For more detailed instructions and examples on the usage or waiters, see the waiters user guide.

The available waiters are: