[ aws ]

abuse-signal

Description

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.