AWS Security Hub · Schema

ListSecurityControlDefinitionsResponse

SecurityCloud Security Posture ManagementComplianceFindingsThreat DetectionCloudAmazon Web Services

Properties

Name Type Description
SecurityControlDefinitions array An array of controls that apply to the specified standard.
NextToken string A pagination parameter that's included in the response only if it was included in the request.
View JSON Schema on GitHub

JSON Schema

aws-security-hub-list-security-control-definitions-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aws-security-hub/json-schema/aws-security-hub-list-security-control-definitions-response-schema.json",
  "title": "ListSecurityControlDefinitionsResponse",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aws-security-hub-controls-api-openapi.yml#/components/schemas/ListSecurityControlDefinitionsResponse",
  "type": "object",
  "properties": {
    "SecurityControlDefinitions": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SecurityControlDefinition"
      },
      "description": "An array of controls that apply to the specified standard."
    },
    "NextToken": {
      "type": "string",
      "description": "A pagination parameter that's included in the response only if it was included in the request."
    }
  },
  "required": [
    "SecurityControlDefinitions"
  ],
  "$defs": {
    "BooleanConfigurationOptions": {
      "type": "object",
      "properties": {
        "DefaultValue": {
          "type": "boolean",
          "description": "The Security Hub CSPM default value for a boolean parameter."
        }
      }
    },
    "ConfigurationOptions": {
      "type": "object",
      "properties": {
        "Integer": {
          "$ref": "#/$defs/IntegerConfigurationOptions"
        },
        "IntegerList": {
          "$ref": "#/$defs/IntegerListConfigurationOptions"
        },
        "Double": {
          "$ref": "#/$defs/DoubleConfigurationOptions"
        },
        "String": {
          "$ref": "#/$defs/StringConfigurationOptions"
        },
        "StringList": {
          "$ref": "#/$defs/StringListConfigurationOptions"
        },
        "Boolean": {
          "$ref": "#/$defs/BooleanConfigurationOptions"
        },
        "Enum": {
          "$ref": "#/$defs/EnumConfigurationOptions"
        },
        "EnumList": {
          "$ref": "#/$defs/EnumListConfigurationOptions"
        }
      },
      "description": "Exactly one member is set."
    },
    "DoubleConfigurationOptions": {
      "type": "object",
      "properties": {
        "DefaultValue": {
          "type": "number",
          "description": "The Security Hub CSPM default value for a control parameter that is a double."
        },
        "Min": {
          "type": "number",
          "description": "The minimum valid value for a control parameter that is a double."
        },
        "Max": {
          "type": "number",
          "description": "The maximum valid value for a control parameter that is a double."
        }
      }
    },
    "EnumConfigurationOptions": {
      "type": "object",
      "properties": {
        "DefaultValue": {
          "type": "string",
          "description": "The Security Hub CSPM default value for a control parameter that is an enum."
        },
        "AllowedValues": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The valid values for a control parameter that is an enum."
        }
      }
    },
    "EnumListConfigurationOptions": {
      "type": "object",
      "properties": {
        "DefaultValue": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The Security Hub CSPM default value for a control parameter that is a list of enums."
        },
        "MaxItems": {
          "type": "integer",
          "description": "The maximum number of list items that an enum list control parameter can accept."
        },
        "AllowedValues": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The valid values for a control parameter that is a list of enums."
        }
      }
    },
    "IntegerConfigurationOptions": {
      "type": "object",
      "properties": {
        "DefaultValue": {
          "type": "integer",
          "description": "The Security Hub CSPM default value for a control parameter that is an integer."
        },
        "Min": {
          "type": "integer",
          "description": "The minimum valid value for a control parameter that is an integer."
        },
        "Max": {
          "type": "integer",
          "description": "The maximum valid value for a control parameter that is an integer."
        }
      }
    },
    "IntegerListConfigurationOptions": {
      "type": "object",
      "properties": {
        "DefaultValue": {
          "type": "array",
          "items": {
            "type": "integer"
          },
          "description": "The Security Hub CSPM default value for a control parameter that is a list of integers."
        },
        "Min": {
          "type": "integer",
          "description": "The minimum valid value for a control parameter that is a list of integers."
        },
        "Max": {
          "type": "integer",
          "description": "The maximum valid value for a control parameter that is a list of integers."
        },
        "MaxItems": {
          "type": "integer",
          "description": "The maximum number of list items that an interger list control parameter can accept."
        }
      }
    },
    "ParameterDefinition": {
      "type": "object",
      "properties": {
        "Description": {
          "type": "string",
          "description": "Description of a control parameter."
        },
        "ConfigurationOptions": {
          "$ref": "#/$defs/ConfigurationOptions"
        }
      },
      "required": [
        "Description",
        "ConfigurationOptions"
      ]
    },
    "SecurityControlDefinition": {
      "type": "object",
      "properties": {
        "SecurityControlId": {
          "type": "string",
          "description": "The unique identifier of a security control across standards. Values for this field typically consist of an Amazon Web Services service name and a number (for example, APIGateway.3). This parameter differs from SecurityControlArn, which is a unique Amazon Resource Name (ARN) assigned to a control. The ARN references the security control ID (for example, arn:aws:securityhub:eu-central-1:123456789012:security-control/APIGateway.3)."
        },
        "Title": {
          "type": "string",
          "description": "The title of a security control."
        },
        "Description": {
          "type": "string",
          "description": "The description of a security control across standards. This typically summarizes how Security Hub CSPM evaluates the control and the conditions under which it produces a failed finding. This parameter doesn't reference a specific standard."
        },
        "RemediationUrl": {
          "type": "string",
          "description": "A link to Security Hub CSPM documentation that explains how to remediate a failed finding for a security control."
        },
        "SeverityRating": {
          "type": "string",
          "enum": [
            "LOW",
            "MEDIUM",
            "HIGH",
            "CRITICAL"
          ],
          "description": "The severity of a security control. For more information about how Security Hub CSPM determines control severity, see Assigning severity to control findings in the Security Hub CSPM User Guide."
        },
        "CurrentRegionAvailability": {
          "type": "string",
          "enum": [
            "AVAILABLE",
            "UNAVAILABLE"
          ],
          "description": "Specifies whether a security control is available in the current Amazon Web Services Region."
        },
        "CustomizableProperties": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "Parameters"
            ]
          },
          "description": "Security control properties that you can customize. Currently, only parameter customization is supported for select controls. An empty array is returned for controls that don’t support custom properties."
        },
        "ParameterDefinitions": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/$defs/ParameterDefinition"
          },
          "description": "An object that provides a security control parameter name, description, and the options for customizing it. This object is excluded for a control that doesn't support custom parameters."
        },
        "Provider": {
          "type": "string",
          "enum": [
            "AWS",
            "Azure"
          ],
          "description": "The cloud provider whose resources the security control evaluates. For example, AWS or Azure."
        }
      },
      "required": [
        "SecurityControlId",
        "Title",
        "Description",
        "RemediationUrl",
        "SeverityRating",
        "CurrentRegionAvailability"
      ]
    },
    "StringConfigurationOptions": {
      "type": "object",
      "properties": {
        "DefaultValue": {
          "type": "string",
          "description": "The Security Hub CSPM default value for a control parameter that is a string."
        },
        "Re2Expression": {
          "type": "string",
          "description": "An RE2 regular expression that Security Hub CSPM uses to validate a user-provided control parameter string."
        },
        "ExpressionDescription": {
          "type": "string",
          "description": "The description of the RE2 regular expression."
        }
      }
    },
    "StringListConfigurationOptions": {
      "type": "object",
      "properties": {
        "DefaultValue": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The Security Hub CSPM default value for a control parameter that is a list of strings."
        },
        "Re2Expression": {
          "type": "string",
          "description": "An RE2 regular expression that Security Hub CSPM uses to validate a user-provided list of strings for a control parameter."
        },
        "MaxItems": {
          "type": "integer",
          "description": "The maximum number of list items that a string list control parameter can accept."
        },
        "ExpressionDescription": {
          "type": "string",
          "description": "The description of the RE2 regular expression."
        }
      }
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/aws-security-hub-list-security-control-definitions-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.