events

Admitted input schema

{
  "type": "object",
  "properties": {
    "az": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Restrict to one availability zone / zone id (for example `use1-az1`). Default: all zones."
    },
    "from": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "date-time",
      "description": "Start of the window (inclusive), ISO 8601 UTC. Default: 7 days before `to`."
    },
    "include_repeats": {
      "type": "boolean",
      "description": "Keep events whose price equals the previous event of the same (az, product) series. Default false.",
      "default": false
    },
    "instance": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Instance / machine / SKU type name exactly as listed by /instances (for example `c5.large`, `n2-standard-4`, `D2s_v5`).",
      "examples": [
        "c5.large"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000,
      "description": "Maximum rows to return (1 to 10000). Default 5000.",
      "default": 5000
    },
    "product": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Restrict to one product / OS string (for example `Linux/UNIX`, `Spot`, `Linux`). Default: all."
    },
    "provider": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "aws",
        "gcp",
        "azure"
      ],
      "description": "Cloud provider. One of `aws`, `gcp`, `azure`."
    },
    "region": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Region slug as listed by /catalog (for example `us-east-1` for AWS, `us-central1` for GCP, `us-east` for Azure). Azure slugs map to `eastus`, `westus2`, `westeurope`.",
      "examples": [
        "us-east-1"
      ]
    },
    "to": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "format": "date-time",
      "description": "End of the window (exclusive), ISO 8601 UTC. Default: now."
    }
  },
  "required": [
    "provider",
    "region",
    "instance"
  ],
  "additionalProperties": false
}