Amazon Shield

AWS Shield is a managed Distributed Denial of Service (DDoS) protection service that safeguards applications running on AWS. It provides always-on detection and automatic inline mitigations that minimize application downtime and latency, with two tiers of protection - Shield Standard for automatic defense against common attacks and Shield Advanced for enhanced detection and 24/7 access to the DDoS Response Team.

Amazon Shield publishes 7 APIs on the APIs.io network, including Amazon Shield REST API API, #CreateProtectionGroup API, #CreateSubscription API, and 4 more. Tagged areas include DDoS Protection, Networking, and Security.

The Amazon Shield catalog on APIs.io includes 2 JSON-LD contexts and 2 Spectral governance rulesets.

Amazon Shield’s developer surface includes authentication, developer portal, documentation, support, signup flow, code examples, and 62 more developer resources.

🌐 Visit website 📡 Source on GitHub

62.2/100 strong ▬ flat Agent 32/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

7 APIs

DDoS ProtectionNetworkingSecurity

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 62.2/100 · strong

Contract Quality 17.0 / 25

Developer Ergonomics 7.4 / 20

Commercial Clarity 16.3 / 20

Operational Transparency 6.8 / 13

Governance 8.3 / 12

Discoverability 6.5 / 10

Agent readiness — 32/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/amazon-shield: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

Amazon Shield Amazon Shield REST API API

The Amazon Shield REST API API from Amazon Shield — 1 operation(s) for amazon shield rest api.

Amazon Shield #CreateProtectionGroup API

The #CreateProtectionGroup API from Amazon Shield — 1 operation(s) for #createprotectiongroup.

Amazon Shield #CreateSubscription API

The #CreateSubscription API from Amazon Shield — 1 operation(s) for #createsubscription.

Amazon Shield #DescribeAttack API

The #DescribeAttack API from Amazon Shield — 1 operation(s) for #describeattack.

Amazon Shield #DescribeProtection API

The #DescribeProtection API from Amazon Shield — 1 operation(s) for #describeprotection.

Amazon Shield #DescribeSubscription API

The #DescribeSubscription API from Amazon Shield — 1 operation(s) for #describesubscription.

Amazon Shield #ListProtections API

The #ListProtections API from Amazon Shield — 1 operation(s) for #listprotections.

Scroll for all 7

Postman Collections 7

Ready-to-run Postman collections for exercising this provider's APIs.

Amazon Shield REST Amazon Shield REST API API

POSTMAN

Amazon Shield REST Amazon Shield REST API #CreateProtectionGroup API

POSTMAN

Amazon Shield REST Amazon Shield REST API #CreateSubscription API

POSTMAN

Amazon Shield REST Amazon Shield REST API #DescribeAttack API

POSTMAN

Amazon Shield REST Amazon Shield REST API #DescribeProtection API

POSTMAN

Amazon Shield REST Amazon Shield REST API #DescribeSubscription API

POSTMAN

Amazon Shield REST Amazon Shield REST API #ListProtections API

POSTMAN

Scroll for all 7

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Amazon Shield REST API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Amazon Shield Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Amazon Shield Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Amazon Shield Finops

FINOPS

Semantic Vocabularies 2

JSON-LD contexts and semantic vocabularies used across these APIs.

Amazon Shield Context

14 classes · 31 properties

JSON-LD

Amazon Shield Context

0 classes · 3 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Amazon Shield API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Amazon Shield API Rules

24 rules · 8 errors 15 warnings 1 info

SPECTRAL

JSON Schema 15

Standalone JSON Schema definitions for this provider's data models.

AttackDetail

6 properties

JSON SCHEMA

CreateProtectionGroupRequest

5 properties

JSON SCHEMA

CreateProtectionRequest

3 properties

JSON SCHEMA

CreateProtectionResponse

1 properties

JSON SCHEMA

DescribeAttackRequest

1 properties

JSON SCHEMA

DescribeAttackResponse

1 properties

JSON SCHEMA

DescribeProtectionRequest

2 properties

JSON SCHEMA

DescribeProtectionResponse

1 properties

JSON SCHEMA

ListProtectionsRequest

2 properties

JSON SCHEMA

ListProtectionsResponse

2 properties

JSON SCHEMA

Mitigation

1 properties

JSON SCHEMA

Protection

5 properties

JSON SCHEMA

SummarizedCounter

6 properties

JSON SCHEMA

Tag

2 properties

JSON SCHEMA

Amazon Shield Protection

7 properties

JSON SCHEMA

Scroll for all 15

JSON Structure 15

JSON Structure definitions describing this provider's data shapes.

Amazon Shield Api Attack Detail Structure

6 properties

JSON STRUCTURE

Amazon Shield Api Create Protection Group Request Structure

5 properties

JSON STRUCTURE

Amazon Shield Api Create Protection Request Structure

3 properties

JSON STRUCTURE

Amazon Shield Api Create Protection Response Structure

1 properties

JSON STRUCTURE

Amazon Shield Api Describe Attack Request Structure

1 properties

JSON STRUCTURE

Amazon Shield Api Describe Attack Response Structure

1 properties

JSON STRUCTURE

Amazon Shield Api Describe Protection Request Structure

2 properties

JSON STRUCTURE

Amazon Shield Api Describe Protection Response Structure

1 properties

JSON STRUCTURE

Amazon Shield Api List Protections Request Structure

2 properties

JSON STRUCTURE

Amazon Shield Api List Protections Response Structure

2 properties

JSON STRUCTURE

Amazon Shield Api Mitigation Structure

1 properties

JSON STRUCTURE

Amazon Shield Api Protection Structure

5 properties

JSON STRUCTURE

Amazon Shield Api Summarized Counter Structure

6 properties

JSON STRUCTURE

Amazon Shield Api Tag Structure

2 properties

JSON STRUCTURE

Amazon Shield Protection Structure

7 properties

JSON STRUCTURE

Scroll for all 15

Examples 15

Example request and response payloads for these APIs.

Amazon Shield Api Attack Detail Example

6 fields

EXAMPLE

Amazon Shield Api Create Protection Group Request Example

5 fields

EXAMPLE

Amazon Shield Api Create Protection Request Example

3 fields

EXAMPLE

Amazon Shield Api Create Protection Response Example

1 fields

EXAMPLE

Amazon Shield Api Describe Attack Request Example

1 fields

EXAMPLE

Amazon Shield Api Describe Attack Response Example

1 fields

EXAMPLE

Amazon Shield Api Describe Protection Request Example

2 fields

EXAMPLE

Amazon Shield Api Describe Protection Response Example

1 fields

EXAMPLE

Amazon Shield Api List Protections Request Example

2 fields

EXAMPLE

Amazon Shield Api List Protections Response Example

2 fields

EXAMPLE

Amazon Shield Api Mitigation Example

1 fields

EXAMPLE

Amazon Shield Api Protection Example

5 fields

EXAMPLE

Amazon Shield Api Summarized Counter Example

6 fields

EXAMPLE

Amazon Shield Api Tag Example

2 fields

EXAMPLE

Amazon Shield Protection Example

7 fields

EXAMPLE

Scroll for all 15

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Amazon Shield Authentication

apiKey · 1 scheme

SECURITY

Amazon Shield Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Amazon Shield Vulnerability Disclosure

security.txt · contact published

SECURITY

Amazon Shield Trust Center

PCI DSS, HIPAA, FedRAMP, GDPR, FIPS 140

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Amazon Shield Agentic Access

7 operations · 7 acting

7 operations · 7 acting

AGENTIC

Resources

Get Started 5

Portal, sign-up, and the first successful call

Portal

Portal

Portal

Signup

Login

Documentation 17

Reference material describing how the API behaves

Documentation

OpenAPI

Scroll for all 17

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

Design & Contract 19

Pagination, idempotency, versioning, errors, and events

JSONLD

JSONLD

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

JSONStructure

SpectralRules

Scroll for all 19

Build 17

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHubOrganization

GitHubOrganization

Scroll for all 17

Access & Security 4

Authentication, authorization, and security posture

TrustCenter

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

Operate 3

Status, limits, changes, and where to get help

Support

Contact

Commercial 2

Pricing, plans, and the legal terms of use

TermsOfService

PrivacyPolicy

Source (apis.yml)

name: Amazon Shield
description: AWS Shield is a managed Distributed Denial of Service (DDoS) protection service that safeguards applications
  running on AWS. It provides always-on detection and automatic inline mitigations that minimize application downtime and
  latency, with two tiers of protection - Shield Standard for automatic defense against common attacks and Shield Advanced
  for enhanced detection and 24/7 access to the DDoS Response Team.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://a0.awsstatic.com/libra-css/images/logos/aws_logo_smile_1200x630.png
url: https://raw.githubusercontent.com/api-evangelist/amazon-shield/refs/heads/main/apis.yml
created: '2024-01-15'
modified: '2026-05-19'
apis:
- aid: amazon-shield:amazon-shield-amazon-shield-rest-api-api
  name: Amazon Shield Amazon Shield REST API API
  description: The Amazon Shield REST API API from Amazon Shield — 1 operation(s) for amazon shield rest api.
  humanURL: https://aws.amazon.com/shield/
  baseURL: https://shield.amazonaws.com
  tags:
  - Amazon Shield REST API
  properties:
  - type: OpenAPI
    url: openapi/amazon-shield-amazon-shield-rest-api-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html
  - type: Pricing
    url: https://aws.amazon.com/shield/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/shield/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/shield/faqs/
- aid: amazon-shield:amazon-shield-createprotectiongroup-api
  name: 'Amazon Shield #CreateProtectionGroup API'
  description: 'The #CreateProtectionGroup API from Amazon Shield — 1 operation(s) for #createprotectiongroup.'
  humanURL: https://aws.amazon.com/shield/
  baseURL: https://shield.amazonaws.com
  tags:
  - '#CreateProtectionGroup'
  properties:
  - type: OpenAPI
    url: openapi/amazon-shield-createprotectiongroup-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html
  - type: Pricing
    url: https://aws.amazon.com/shield/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/shield/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/shield/faqs/
- aid: amazon-shield:amazon-shield-createsubscription-api
  name: 'Amazon Shield #CreateSubscription API'
  description: 'The #CreateSubscription API from Amazon Shield — 1 operation(s) for #createsubscription.'
  humanURL: https://aws.amazon.com/shield/
  baseURL: https://shield.amazonaws.com
  tags:
  - '#CreateSubscription'
  properties:
  - type: OpenAPI
    url: openapi/amazon-shield-createsubscription-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html
  - type: Pricing
    url: https://aws.amazon.com/shield/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/shield/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/shield/faqs/
- aid: amazon-shield:amazon-shield-describeattack-api
  name: 'Amazon Shield #DescribeAttack API'
  description: 'The #DescribeAttack API from Amazon Shield — 1 operation(s) for #describeattack.'
  humanURL: https://aws.amazon.com/shield/
  baseURL: https://shield.amazonaws.com
  tags:
  - '#DescribeAttack'
  properties:
  - type: OpenAPI
    url: openapi/amazon-shield-describeattack-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html
  - type: Pricing
    url: https://aws.amazon.com/shield/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/shield/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/shield/faqs/
- aid: amazon-shield:amazon-shield-describeprotection-api
  name: 'Amazon Shield #DescribeProtection API'
  description: 'The #DescribeProtection API from Amazon Shield — 1 operation(s) for #describeprotection.'
  humanURL: https://aws.amazon.com/shield/
  baseURL: https://shield.amazonaws.com
  tags:
  - '#DescribeProtection'
  properties:
  - type: OpenAPI
    url: openapi/amazon-shield-describeprotection-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html
  - type: Pricing
    url: https://aws.amazon.com/shield/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/shield/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/shield/faqs/
- aid: amazon-shield:amazon-shield-describesubscription-api
  name: 'Amazon Shield #DescribeSubscription API'
  description: 'The #DescribeSubscription API from Amazon Shield — 1 operation(s) for #describesubscription.'
  humanURL: https://aws.amazon.com/shield/
  baseURL: https://shield.amazonaws.com
  tags:
  - '#DescribeSubscription'
  properties:
  - type: OpenAPI
    url: openapi/amazon-shield-describesubscription-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html
  - type: Pricing
    url: https://aws.amazon.com/shield/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/shield/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/shield/faqs/
- aid: amazon-shield:amazon-shield-listprotections-api
  name: 'Amazon Shield #ListProtections API'
  description: 'The #ListProtections API from Amazon Shield — 1 operation(s) for #listprotections.'
  humanURL: https://aws.amazon.com/shield/
  baseURL: https://shield.amazonaws.com
  tags:
  - '#ListProtections'
  properties:
  - type: OpenAPI
    url: openapi/amazon-shield-listprotections-api-openapi.yml
  - type: Documentation
    url: https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html
  - type: Pricing
    url: https://aws.amazon.com/shield/pricing/
  - type: GettingStarted
    url: https://aws.amazon.com/shield/getting-started/
  - type: FAQ
    url: https://aws.amazon.com/shield/faqs/
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/amazon-shield/overview
- type: AgenticAccess
  url: agentic-access/amazon-shield-agentic-access.yml
- type: TrustCenter
  url: security/amazon-shield-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/amazon-shield-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/amazon-shield-domain-security.yml
- type: Authentication
  url: authentication/amazon-shield-authentication.yml
- type: Portal
  url: https://aws.amazon.com/
- type: Portal
  url: https://aws.amazon.com/shield/
- type: Documentation
  url: https://docs.aws.amazon.com/waf/latest/developerguide/shield-chapter.html
- type: TermsOfService
  url: https://aws.amazon.com/service-terms/
- type: PrivacyPolicy
  url: https://aws.amazon.com/privacy/
- type: Support
  url: https://aws.amazon.com/premiumsupport/
- type: GitHubOrganization
  url: https://github.com/aws
- type: Portal
  url: https://console.aws.amazon.com/wafv2/shieldv2
- type: Signup
  url: https://signin.aws.amazon.com/signup?request_type=register
- type: Login
  url: https://aws.amazon.com/console/
- type: StatusPage
  url: https://health.aws.amazon.com/health/status
- type: Contact
  url: https://aws.amazon.com/contact-us/
- type: JSONLD
  url: json-ld/amazon-shield-context-context.jsonld
- type: JSONLD
  url: json-ld/amazon-shield-context.jsonld
- type: JSONSchema
  url: json-schema/amazon-shield-api-attack-detail-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-create-protection-group-request-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-create-protection-request-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-create-protection-response-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-describe-attack-request-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-describe-attack-response-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-describe-protection-request-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-describe-protection-response-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-list-protections-request-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-list-protections-response-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-mitigation-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-protection-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-summarized-counter-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-api-tag-schema.json
- type: JSONSchema
  url: json-schema/amazon-shield-protection-schema.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-attack-detail-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-create-protection-group-request-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-create-protection-request-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-create-protection-response-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-describe-attack-request-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-describe-attack-response-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-describe-protection-request-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-describe-protection-response-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-list-protections-request-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-list-protections-response-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-mitigation-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-protection-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-summarized-counter-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-api-tag-structure.json
- type: JSONStructure
  url: json-structure/amazon-shield-protection-structure.json
- type: Examples
  url: examples/amazon-shield-api-attack-detail-example.json
- type: Examples
  url: examples/amazon-shield-api-create-protection-group-request-example.json
- type: Examples
  url: examples/amazon-shield-api-create-protection-request-example.json
- type: Examples
  url: examples/amazon-shield-api-create-protection-response-example.json
- type: Examples
  url: examples/amazon-shield-api-describe-attack-request-example.json
- type: Examples
  url: examples/amazon-shield-api-describe-attack-response-example.json
- type: Examples
  url: examples/amazon-shield-api-describe-protection-request-example.json
- type: Examples
  url: examples/amazon-shield-api-describe-protection-response-example.json
- type: Examples
  url: examples/amazon-shield-api-list-protections-request-example.json
- type: Examples
  url: examples/amazon-shield-api-list-protections-response-example.json
- type: Examples
  url: examples/amazon-shield-api-mitigation-example.json
- type: Examples
  url: examples/amazon-shield-api-protection-example.json
- type: Examples
  url: examples/amazon-shield-api-summarized-counter-example.json
- type: Examples
  url: examples/amazon-shield-api-tag-example.json
- type: Examples
  url: examples/amazon-shield-protection-example.json
- type: SpectralRules
  url: rules/amazon-shield-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/amazon-shield-vocabulary.yaml
- type: OpenAPI
  url: openapi/amazon-shield-api-openapi.yml
- type: Integrations
  url: https://aws.amazon.com/partners/
integrations:
- name: Partner Programs
- name: Resources
- name: Success Stories
- name: Work with an AWS Partner
- name: AWS Marketplace
- name: AWS Partner Central
- name: Partner Paths
- name: co-sell with AWS
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
  url: https://apievangelist.com
tags:
- AWS
- DDoS Protection
- Networking
- Security